go modules 自 go 1.16 起强制启用，模块路径须为合法导入标识符（如 github.com/user/repo），go get 修改 go.mod 并下载依赖至缓存，go.sum 是构建校验依据不可手动编辑，go mod tidy 同步 import 与 require 并保留必要 indirect 依赖。
Go Modules 不是“可选工具”，而是自 Go 1.16 起强制启用的构建基础——只要项目里有 go.mod，就进入模块模式，GOPATH 对依赖解析已完全失效。
go mod init 为什么必须指定合法模块路径
执行 go mod init 时若省略参数，Go 会尝试从当前目录名推断路径（如 myproject → myproject），但这会导致后续 import 失败：Go 要求模块路径必须是可导入的完整标识符，不能是本地相对路径或裸文件名。
- 正确写法：
go mod init github.com/username/myapp或go mod init example.com/mytool - 错误写法：
go mod init ./myapp、go mod init myapp（无域名前缀）、go mod init . - 模块路径不一定要对应真实仓库地址，但必须满足 Go 的导入规则：支持
/分隔、首段不能是数字、不能含大写字母（除非用 Unicode 转义）
go get 不是“安装命令”，而是版本声明操作
go get 的本质是修改 go.mod 中的 require 行，并触发下载。它不会把包装进全局环境，也不改变本地 GOPATH —— 所有依赖都按模块路径+版本号存放在 $GOPATH/pkg/mod 的扁平化缓存中。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 添加新依赖：
go get github.com/sirupsen/logrus@v1.9.3（显式锁定版本） - 升级到最新 minor：
go get -u github.com/sirupsen/logrus（等价于@latest，但受go.sum和最小版本选择 MVS 约束） - 降级或切分支：
go get github.com/sirupsen/logrus@master或@7a4f52b（此时go.mod中版本显示为伪版本v1.9.3-0.20230101000000-7a4f52b） - 删除依赖：不能靠
go get xxx@none，必须删掉代码里的import，再运行go mod tidy
go.sum 不是“校验清单”，而是内容指纹快照
go.sum 每行记录一个模块路径 + 版本 + 两个哈希值（h1: 是模块 zip 内容哈希，go.mod 单独哈希）。它不是用来“验证安全性”的独立机制，而是构建过程中强制校验的依据：一旦本地缓存的模块内容与 go.sum 不符，go build 直接失败，报错 checksum mismatch。
- 不要手动编辑
go.sum；它由 Go 工具链自动维护 - 多人协作时，
go.sum必须提交进 Git —— 缺失或过期会导致不同机器构建结果不一致 - 私有模块若未配置
GOPRIVATE，Go 仍会尝试向代理请求校验数据，可能超时或 403；此时需设go env -w GOPRIVATE=git.example.com/internal
go mod tidy 的真实作用被严重低估
go mod tidy 不只是“整理依赖”，它是模块图的权威同步器：它扫描全部 .go 文件中的 import，对比 go.mod 中的 require，然后做两件事——补全缺失的直接依赖，移除未被引用的 require 行（包括间接依赖项）。
- 它不会自动升级已有依赖版本，也不会修复
go.sum中缺失的条目（那些得靠go build或go list触发） - CI 流程中应在
go build前加go mod tidy -v，输出变化可快速发现意外引入/丢失的依赖 - 若
go.mod里有// indirect标记的依赖，说明它没被当前模块直接 import，只被其他依赖引用；tidy保留它们是必要的，删掉可能导致编译失败
最易忽略的一点：模块版本不是“写死在代码里”的字符串，而是由整个依赖图共同决定的——哪怕你显式 go get A@v2.0.0，只要另一个依赖 B 要求 A@v1.5.0，MVS 算法仍可能选 v1.5.0。要看最终生效版本，得用 go list -m all | grep A，而不是只盯 go.mod。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
