模块路径写错会导致后续所有依赖解析失败；必须使用未来发布地址如github.com/username/project，而非本地目录名或非法字符路径，否则import无法解析、go get和CI构建将失败。
go mod init 时模块路径写错会导致后续所有依赖解析失败
模块路径不是随便起的，它直接决定 import 语句能否被正确解析、依赖能否被拉取。比如你在 ~/myproject 下执行 go mod init myproject，那代码里就必须用 import "myproject/xxx" —— 但这个路径无法被公网识别，别人 clone 你的项目后 go build 会报 cannot find module providing package。
真正该写的是未来发布地址，例如 GitHub 仓库地址：go mod init github.com/yourname/myproject。这样别人 import 你写的包时才不会出问题，CI 构建、go get 安装也才能正常走通。
- 路径中不能含空格、中文或非法字符（如
@、#） - 避免用
./或相对路径开头，go mod init ./myproject是非法的 - 如果项目已在
$GOPATH/src下，Go 可能 fallback 到 GOPATH mode；加GO111MODULE=on强制启用模块模式
go get 拉取三方组件时没指定版本，实际行为远比“最新版”复杂
go get github.com/sirupsen/logrus 看似简单，但它默认拉取的是「latest tagged version」，不是 master 最新 commit，也不是 semver 最高 minor 版。更麻烦的是：如果该模块没有 tag，Go 会生成一个伪版本（如 v1.9.3-0.20230512142301-abc123），而这个伪版本在不同机器上可能不一致——导致构建不可重现。
生产环境必须显式锁定版本：
立即学习“go语言免费学习笔记（深入）”；
- 拉指定 tag：
go get github.com/sirupsen/logrus@v1.9.3 - 拉特定 commit：
go get github.com/sirupsen/logrus@abc123def - 拉分支（慎用）：
go get github.com/sirupsen/logrus@main→ 会转成伪版本，且后续go mod tidy可能意外升级
注意：go get 会同时修改 go.mod 和 go.sum；若只想更新校验值不改依赖，用 go mod download -json 更安全。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
replace 用于本地调试，但上线前必须删掉
开发阶段想用本地修改的 github.com/yourorg/utils 替换远程版本？可以加 replace：
replace github.com/yourorg/utils => ./utils
但这只是开发期 hack：CI 构建时若未清理，go build 会因找不到 ./utils 路径而失败；更隐蔽的问题是，go list -m all 显示的模块路径带 => ./utils，但打包发布的二进制里其实没包含这部分代码。
-
replace必须和require中声明的模块路径完全一致（包括大小写、拼写） - 子模块自身也要有合法
go.mod（module github.com/yourorg/utils），否则 replace 失效 - CI 流水线建议加
GOFLAGS="-mod=readonly"，让 replace 直接报错，提前暴露问题
go.sum 不同步是多模块项目最常踩的坑
主项目和子模块各自有 go.mod 和 go.sum，但很多人只在根目录跑 go mod tidy，结果子模块的 go.sum 还是旧的。构建时可能报 checksum mismatch 或 missing go.sum entry —— 因为 Go 校验时会逐个比对每个模块的 go.sum，缺一不可。
正确做法是：每个模块目录下单独执行 go mod tidy，尤其 CI 构建前：
cd ./modules/user && go mod tidy && cd -cd ./modules/order && go mod tidy && cd -- 再回到根目录运行一次
go mod tidy统一主模块依赖
别合并或删除子模块的 go.sum；它不是冗余文件，而是每个模块独立的完整性凭证。私有仓库还要配 GOPRIVATE=git.company.com/*，否则 go mod download 会绕过认证直接失败。
