真锁定依赖需同时写死go.mod中版本号并提交go.sum;go.mod手动改require行或用go get @version更新最安全,go.sum严禁删改,CI须校验二者一致性。

go.mod 文件里写死版本号,go.sum 文件必须提交到 Git —— 这才是真锁定。Go 不会自动升级,但人一松手就容易漂移。
直接编辑 go.mod 中的 require 行
这是最直白、副作用最小的锁定方式。Go 工具链完全信任 go.mod 里的字面版本,不模糊匹配、不自动升 patch。
- 打开
go.mod,找到类似require github.com/sirupsen/logrus v1.9的行(缺 patch 号) - 把它改成带完整语义化版本的写法:
require github.com/sirupsen/logrus v1.9.3 - 保存后运行
go mod download确保该版本已缓存,再跑go mod verify确认校验和一致 - 此后所有
go build、go test都只用v1.9.3,除非你再次改go.mod或执行go get
用 go get @version 精确拉取并更新
比手动编辑更安全,因为 go get 会同步处理 go.sum 和间接依赖收敛,避免漏掉校验项。
- 升级指定模块:
go get github.com/sirupsen/logrus@v1.9.3 - 锁定到某个 commit(无 tag 时):
go get github.com/sirupsen/logrus@8a7e6c7,会自动生成伪版本如v0.0.0-20230510152458-6b72e3a001f6 - 加
-d参数可跳过编译,只下载并更新go.mod和go.sum:go get -d github.com/sirupsen/logrus@v1.9.3 - 执行后务必检查
go.sum是否新增了对应行;若没变,可能是GOPROXY缓存旧版,加-x强制重试
别碰 go.sum,也别删它
go.sum 不是日志,是强制校验锁。删了或手动改,构建时直接报 checksum mismatch。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
-
go.sum记录的是每个模块的go.mod文件和 zip 包的 SHA256 哈希,不是“缓存快照” - CI/CD 流水线中必须包含检查:
git status --porcelain go.mod go.sum非空则拒绝构建 - 如果
go.sum末尾行数与go list -m -json all | jq '.Version' | wc -l相差超过 ±2 行,说明有依赖未被正确校验或存在冲突 - 遇到校验失败,优先用
go mod tidy -v修复,而不是删go.sum重生成
慎用 replace,尤其别用于生产长期锁定
replace 能绕过版本解析直指 commit,适合调试,但会掩盖真实依赖关系。
立即学习“go语言免费学习笔记(深入)”;
- 临时替换本地路径:
replace github.com/sirupsen/logrus => ./fix-logrus - 强制绑定某 commit:
replace github.com/sirupsen/logrus => github.com/sirupsen/logrus v0.0.0-20230510152458-6b72e3a001f6 -
replace优先级高于require,整个模块图都会生效,但govulncheck不扫描它指向的本地路径 - 上线前必须移除所有
replace行,否则团队成员无法复现构建环境
go get -u,或者忘了把 go.sum 提交进 Git。锁定依赖这件事,技术上已经足够简单,约束力全在流程里。

















