Go Modules 从1.16起默认启用，模块路径须以可解析域名开头；replace仅限当前module生效；go.sum在构建时才更新。
Go Modules 是 Go 1.11 引入的官方包管理机制，从 Go 1.16 开始默认启用——这意味着你不再需要 GO111MODULE=on 环境变量就能直接使用，只要项目根目录下有 go.mod 文件，Go 工具链就会以 module 模式工作。
如何初始化一个新 module 并正确设置模块路径
模块路径（module path）不是随便起的，它会直接影响依赖解析、版本发布和 go get 行为。常见错误是用本地路径（如 ./myapp）或不带域名的名称（如 utils）作为模块名，这会导致后续无法被他人引用，也破坏语义化版本兼容性判断。
- 模块路径应以可解析的域名开头，例如
github.com/username/project或gitlab.example.com/org/repo - 运行
go mod init github.com/username/mycli初始化，Go 会自动生成go.mod文件并记录当前 Go 版本（如go 1.21） - 如果项目已存在且依赖了外部包，
go mod init后需立即执行go build或go list -m all，触发 Go 自动补全require条目 - 模块路径一旦写入
go.mod，就不要轻易修改；若必须改，所有下游依赖都需同步更新 import 路径
为什么 go get 有时不更新 go.sum 或下载源码
go get 的行为取决于参数和当前上下文：它既可能升级依赖，也可能只更新 go.mod 中的版本声明，甚至跳过下载——尤其当目标包已在本地缓存且满足版本约束时。
- 要强制下载并记录最新兼容版本，用
go get example.com/pkg@latest（注意@latest） - 仅更新
go.mod但不拉取代码？那是go get -d的效果，常被误用 -
go.sum不更新，大概率是因为你没真正触发依赖变更（比如go get后没运行go build或go test），Go 只在实际构建时才校验并写入 checksum - 私有仓库未配置
GOPRIVATE时，go get会尝试走 proxy（如 proxy.golang.org），导致 403 或 timeout，此时需提前设置go env -w GOPRIVATE=git.internal.company/*
如何安全地替换依赖（比如用 fork 版本替代上游）
直接改 go.mod 里的 require 行是危险的：Go 不会验证 checksum，下次 go mod tidy 可能把它“修正”回去。必须用 replace 指令，并确保 fork 与原版 API 兼容。
立即学习“go语言免费学习笔记（深入）”；
- 在
go.mod末尾添加：replace github.com/original/lib => github.com/yourname/lib v1.2.3
- 如果 fork 尚未打 tag，可用 commit hash：
replace github.com/original/lib => ./local-fork
（路径必须是相对路径，且该目录下要有go.mod） -
replace仅作用于当前 module，不会影响下游项目；若希望传播替换，需用go mod edit -replace并提交go.mod - 上线前务必删掉
replace并验证原版是否已修复问题，否则容易积累技术债
模块路径设计、replace 的作用域、以及 go.sum 的触发时机，这三处最容易在协作中引发隐性问题——它们不报错，但会让不同机器构建出不一致的二进制，或者让 CI 环境突然失败。
