Go 1.11 引入 go mod 作为官方依赖管理工具，推荐启用 GO111MODULE=on 后使用 go mod init 初始化项目，模块名建议用完整路径；应使用具体语义化版本添加依赖，如 go get pkg@v1.5.0，避免 latest 或分支导致不一致；通过 go mod tidy 清理未使用依赖并补全缺失项，保持 go.mod 和 go.sum 整洁；提交 go.sum 以确保依赖完整性，结合 replace 和 require 锁定版本，CI/CD 中使用 -mod=readonly 防止修改；生产环境建议执行 go mod vendor 并用 -mod=vendor 构建，实现离线稳定构建；私有模块需配置 GOPRIVATE、GONOPROXY 和 GOPROXY 确保拉取正确；定期运行 go list -m -u all 升级依赖，配合 govulncheck 扫描漏洞，提升安全性与稳定性。
Go 语言从 1.11 版本开始引入了 Go Modules（go mod），作为官方依赖管理工具，取代了传统的
GOPATH模式。使用 go mod 能更好地管理项目依赖版本、提升构建可重复性，并支持离线开发。以下是 Golang 服务中使用 go mod 的一些最佳实践。
1. 启用 Go Modules 并初始化项目
确保环境变量
GO111MODULE=on（Go 1.16+ 默认开启），然后在项目根目录运行：
go mod init your-project-name
这会生成
go.mod文件，记录模块名和 Go 版本。建议模块名使用完整路径（如
github.com/your-org/your-service），便于发布和引用。
2. 明确依赖版本，避免使用主干分支
在
go.mod中应尽量使用具体的语义化版本（如
v1.2.3），而不是
latest或 Git 分支（如
master）。这能保证构建的一致性和可追溯性。
立即学习“go语言免费学习笔记（深入）”；
添加依赖时，推荐使用：
go get github.com/some/pkg@v1.5.0
而不是：
go get github.com/some/pkg
使用具体版本可防止因上游变更导致的意外 break。
3. 定期清理和整理依赖
使用以下命令自动清理未使用的依赖：
go mod tidy
该命令会：
- 添加缺失的依赖（代码中引用但未在 go.mod 中）
- 移除未被引用的依赖
- 确保
go.sum
完整
建议在每次修改代码或提交前运行
go mod tidy，保持依赖整洁。
4. 锁定依赖，确保构建可重现
go.sum文件记录了每个依赖模块的哈希值，用于校验完整性。务必将其提交到版本控制中。
如需完全锁定依赖版本（包括间接依赖），可在
go.mod中使用
replace或
require明确指定版本。例如：
require (
github.com/pkg/errors v0.9.1
golang.org/x/sync v0.2.0
)
replace golang.org/x/sync => golang.org/x/sync v0.2.0
在 CI/CD 中构建服务时，使用
go build -mod=readonly防止意外修改
go.mod。
5. 使用 vendor 目录（可选但推荐用于生产）
对于生产环境部署，建议将依赖打包进
vendor目录，避免构建时网络拉取失败：
go mod vendor
然后使用：
go build -mod=vendor
这能确保构建完全离线、稳定且一致，适合高可用服务。
6. 处理私有模块依赖
若依赖公司内部 Git 仓库，需配置
GOPRIVATE环境变量，避免 go 命令尝试通过公共代理拉取：
export GOPRIVATE=git.company.com,github.com/your-org/private-repo
同时可设置代理：
go env -w GOPROXY=https://proxy.golang.org,direct go env -w GONOPROXY=git.company.com
确保私有模块能正确拉取。
7. 定期升级依赖并做安全检查
使用
go list -m -u all查看可升级的依赖：
go list -m -u all
结合
govulncheck（Go 安全扫描工具）检查已知漏洞：
govulncheck ./...
定期更新关键依赖，尤其是标准库和安全相关库。
基本上就这些。合理使用 go mod 能让 Golang 服务的依赖清晰可控，提升团队协作效率和系统稳定性。不复杂但容易忽略。
