1️⃣ 初始化模块

如果你是新项目，需要先创建 go.mod：

go mod init <module_path>

• module_path 通常是你的仓库路径（比如 GitHub）：

go mod init github.com/username/myproject

• 生成 go.mod 文件：

module github.com/username/myproject

go 1.20

✅ 这一步等于告诉 Go：这是一个独立的模块，可以管理依赖。

2️⃣ 添加第三方依赖

有几种方式：

2.1 go get

go get <module>@<version>

示例：

go get github.com/gofiber/fiber/v3@latest
go get github.com/gofiber/utils/v2@v2.10.0

• Go 会：

1. 拉取源码（通过 Go Proxy / GitHub）
2. 写入 go.mod 和 go.sum
3. 确保版本一致性

如果不指定版本，默认 latest

2.2 自动添加（在代码里 import）

• 如果在代码中直接写：

import "github.com/gofiber/fiber/v3"

然后运行：

go mod tidy

• Go 会：

• 自动在 go.mod 添加依赖

• 下载依赖到本地缓存 $GOPATH/pkg/mod

• 清理未使用的依赖

2.3 replace（本地模块覆盖远程依赖）

replace github.com/gofiber/utils/v2 => ../utils/v2

• 本地开发用本地源码覆盖远程模块
• 常用于调试或者多人开发

3️⃣ 更新依赖

go get -u <module>

• 更新模块到最新小版本或次版本
• 更新 go.mod 和 go.sum

4️⃣ 删除未使用依赖

go mod tidy

• 自动清理 go.mod 中不再使用的模块
• 确保项目干净

5️⃣ 常用命令总结

✅ 核心点：

• 新项目先 go mod init
• 添加依赖用 go get 或 import + go mod tidy
• 本地调试可以用 replace 指定路径
• go.sum 用于校验依赖完整性

如果你需要，我可以帮你画一张 Go 模块依赖添加和解析流程图，展示 go.mod / go.sum / go get / proxy / 本地缓存 的关系，让添加模块的过程一眼看懂。

你希望我画吗？