go.mod文件必须手动执行go mod init初始化生成，否则go build或go run不启用模块模式而回退至gopath路径；模块路径如example.com/myproject作为导入前缀影响依赖解析与版本管理，需保持唯一性并提交go.mod与go.sum至版本控制。
go.mod 文件不是自动生成的，必须手动初始化
项目根目录下没有 go.mod，go build 或 go run 就不会启用模块模式，所有依赖仍走 $GOPATH 老路径。别指望 IDE 或构建工具帮你补上。
执行以下命令生成初始模块声明：
go mod init example.com/myproject
注意：example.com/myproject 是模块路径，不是 URL，也不必真实存在；它会作为所有导入路径的前缀，影响后续 go get 行为和版本解析逻辑。
- 如果项目已上传到 GitHub，建议直接用仓库地址（如
github.com/you/repo），避免后期重命名或迁移时 import 路径不一致 - 模块路径不能以
golang.org、google.golang.org等官方域名开头，否则go get会绕过代理直连，可能失败 - 子模块（如
/cmd、/internal）无需单独go mod init，它们共享根目录的go.mod
升级依赖时，go get -u 不再推荐
go get -u 会无差别升级所有间接依赖，极易引入不兼容变更。Golang 1.16+ 默认启用 GOSUMDB，但乱升版本仍可能导致 go.sum 校验失败或运行时 panic。
正确做法是明确指定要升级的模块及其目标版本：
go get github.com/sirupsen/logrus@v1.9.0
也可以只升级主版本（如从 v1.8.x 升到 v1.9.x）：
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
go get github.com/sirupsen/logrus@latest
-
@latest指向最新 tagged 版本，不是 main 分支 HEAD - 若依赖未打 tag，
@latest会 fallback 到 latest commit，此时go.mod中显示类似v1.8.0-20230101123456-abcdef123456的伪版本号 - 升级后务必检查
go.mod和go.sum是否被修改，并验证go test ./...是否全部通过
go.sum 不是锁文件，但必须提交到 Git
go.sum 记录每个依赖模块的校验和，用于防止依赖被篡改或意外替换。它不是像 package-lock.json 那样的“锁定”文件——你删掉它，go build 会重新生成；但它一旦缺失或内容错误，go 命令会报错并中止构建。
常见误操作：
- 把
go.sum加进.gitignore—— 这会导致 CI 构建失败或本地与远程环境不一致 - 手动编辑
go.sum—— 校验和错一位都会触发checksum mismatch错误 - 多人协作时忽略
go.sum冲突 —— 必须合并而非覆盖，否则校验失效
遇到 verifying github.com/xxx@v1.2.3: checksum mismatch，先确认是否有人删了 go.sum 或用了不同 Go 版本拉取依赖；通常执行 go clean -modcache + go mod download 可恢复。
vendor 目录不是必需的，但跨环境构建时很关键
默认情况下 Go 不生成 vendor 目录，所有依赖从 $GOPATH 或 proxy 下载。但在离线环境、CI 隔离构建、或需要精确控制依赖二进制来源时，go mod vendor 就成了事实标准。
执行后会在项目根目录生成 vendor/，包含所有直接和间接依赖源码：
go mod vendor
- 生成后，可用
go build -mod=vendor强制只读取vendor/，跳过网络请求 -
vendor不会自动更新：改了go.mod后需再次运行go mod vendor - Go 1.14+ 默认关闭 vendor 支持，必须显式加
-mod=vendor参数，否则仍走网络 - 不要把
vendor/当作“替代 GOPATH”的通用方案——它增大仓库体积，且不解决多版本共存问题
模块版本控制真正的复杂点不在命令本身，而在于团队对 go.mod 修改节奏的共识：谁可以升级？什么时候该 pin 版本？replace 和 exclude 是临时手段，留太久就会变成技术债。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
