Go 1.11+推荐用模块管理依赖，需在项目根目录执行go mod init指定唯一模块路径生成go.mod；引入外部包后运行go run或go build会自动下载依赖并更新go.mod和go.sum；常用命令包括go mod tidy、go mod download等；私有仓库需配置GOPRIVATE，调试可用replace临时替换依赖。
在 Go 1.11 及之后版本中，模块（module）是官方推荐的依赖管理方式。初始化项目并创建 go.mod 文件非常简单，关键在于明确项目根目录、正确使用 go mod init，并理解后续依赖管理的基本逻辑。
初始化模块：生成 go.mod 文件
进入你的项目根目录（通常是包含 main.go 或你打算作为模块入口的包所在目录），运行：
go mod init example.com/myproject
其中 example.com/myproject 是你为该模块指定的**模块路径（module path）**，应尽量唯一、可解析（即使不真实存在域名也没关系，但建议模拟真实结构，便于未来发布或协作）。执行后会生成一个 go.mod 文件，内容类似：
立即学习“go语言免费学习笔记（深入）”；
module example.com/myproject
go 1.22
模块路径将作为导入其他包时的前缀（如 import "example.com/myproject/utils"），也影响 Go 工具链如何解析本地或远程依赖。
自动下载与记录依赖
当你在代码中首次引入一个外部包（如 github.com/gin-gonic/gin），并执行构建或运行命令时，Go 会自动下载该依赖，并更新 go.mod 和 go.sum：
-
go run main.go或go build—— 触发依赖解析与下载 -
go.mod中会新增require github.com/gin-gonic/gin v1.9.1（含版本号） -
go.sum记录每个依赖及其子依赖的校验和，保障可重现构建
注意：无需手动 go get（除非你想显式拉取特定版本），日常开发中“写 import → 运行 → 自动补全”即可。
常用依赖管理命令
以下命令帮助你主动维护依赖状态：
-
go mod tidy：清理未使用的依赖，添加缺失的依赖，同步go.mod与实际代码引用。建议每次增删 import 后运行。 -
go mod download：仅下载go.mod中声明的所有依赖到本地缓存（$GOPATH/pkg/mod），不修改文件。 -
go mod graph：输出依赖图（文本格式），适合排查版本冲突。 -
go list -m all：列出当前模块及所有依赖的模块路径和版本。
处理私有仓库或替换依赖
若依赖托管在私有 Git 服务器（如公司内网 GitLab），需配置 GOPRIVATE 环境变量，避免 Go 尝试走 proxy：
export GOPRIVATE=git.mycompany.com/*
如需临时用本地代码替代某远程依赖（比如调试中），可在 go.mod 中添加 replace 语句：
replace github.com/some/dep => ../some-dep
执行 go mod tidy 后即生效。上线前记得移除 replace，或改用 versioned release。
