go get -u 不会升级到 v2+，必须显式指定 /v2 路径；v2 是独立模块而非新版本，需同步更新 module 路径、/v2 子目录结构、所有 import 语句及 go.sum，否则编译失败或拉取错误。
go get -u 不会升级到 v2+，必须显式指定 /v2 路径
很多人执行 go get -u github.com/user/repo 后发现还是 v1.x，以为命令失效——其实不是 bug，是 Go 模块的语义化版本设计使然。go get -u 只会在当前主版本内找最新 minor/patch，绝不会跨到 v2。v2 对 Go 来说不是“新版本”，而是“新模块”。
- 运行
go list -m -u github.com/user/repo，如果输出里有v2.0.0但本地没升，说明它被当作独立路径看待 - 想用 v2，必须写全路径：
go get github.com/user/repo/v2@v2.0.0 - 如果仓库没发布 v2 tag，或没按规范建
/v2子目录，这条命令会报module github.com/user/repo/v2: not found
module 声明和 import 路径必须同步改，否则编译失败
只改 go.mod 里的 module github.com/user/repo/v2 是不够的。Go 构建时会按 import 路径去磁盘找代码，而旧代码还在 github.com/user/repo 下，自然报 cannot find package。
- 仓库根目录下必须存在
/v2子目录，且所有源码放进去（如/v2/pkg/foo.go） - 项目中所有
import "github.com/user/repo"都得手动或脚本替换成import "github.com/user/repo/v2" - 子包也要同步更新：原
"github.com/user/repo/client"→"github.com/user/repo/v2/client" -
go mod tidy不会动 import 语句，这步纯靠人或正则批量处理
v1 和 v2 可共存，但不能混用同一模块的两个路径
Go 允许你在同一个项目里同时 import github.com/user/repo（v1）和 github.com/user/repo/v2（v2），因为它们被视为不同模块。但如果你试图把两者都引入并调用相同名字的函数，大概率会触发 symbol 冲突或类型不匹配。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 常见错误：v1 的
DoSomething()返回error，v2 改成返回Result；混用时编译器无法自动桥接 - 不要为了“兼容”而在同一文件里 import 两个版本——这不是多版本共存的正确用法
- 真正需要双版本过渡时，应按功能边界拆分：比如 CLI 工具用 v1，新 API 服务用 v2，物理隔离依赖链
- 用
go mod graph | grep repo可快速确认当前构建图里实际用了哪个路径
CI/CD 中必须锁定版本，且 go.sum 不可忽略
主版本升级后，go.sum 会新增大量 v2 路径的校验和。如果 CI 流程里删了它、或 .gitignore 里忽略了它，不同机器拉代码后可能拉到同 tag 但内容不同的 zip 包——轻则构建失败，重则引入安全风险。
立即学习“go语言免费学习笔记（深入）”；
- 升级完成后，务必提交更新后的
go.mod和go.sum - CI 脚本禁止出现
go mod tidy -v或go get -u这类修改依赖的命令 - 建议在 CI 中加一步：
go mod verify，确保所有模块哈希与go.sum完全一致 - v2 模块的 tag 必须是标准 SemVer 格式（如
v2.0.0），带+incompatible后缀的版本会被 Go 视为非合规，可能导致go get解析失败
go.sum —— 这些地方一出错，编译报错信息往往不直接指向根源，得倒着查 import 链和模块解析路径。 
