go.mod 是现代 go 项目必需的模块声明文件；需用 go mod init 正确初始化 module path；go.sum 不可手动编辑，是安全校验契约；replace 和 exclude 为临时手段，有风险；go mod tidy 同步依赖关系而非清理冗余。
go.mod 是 Go 模块系统的基石，不是可选配置，而是现代 Go 项目必须存在的声明文件；没有它，go build、go test 等命令在模块感知模式下会拒绝工作或降级为 GOPATH 模式（已废弃）。
如何初始化一个新模块并设置正确的 module path
在项目根目录执行 go mod init example.com/myapp，其中 example.com/myapp 是你的模块路径（module path），它应与代码未来可能被 import 的路径一致。常见错误包括：
- 用本地路径如
go mod init ./src或go mod init myapp—— 这会导致后续go get无法解析依赖，且他人无法正确导入你的包 - 模块路径含大写字母或下划线（如
MyApp_v1）—— Go 官方不推荐，部分工具链（如go list -m all）可能异常 - 未提前规划域名归属：若使用
github.com/username/repo，请确保该路径真实存在且你有写权限，否则go get会失败
为什么 go.sum 不该手动编辑，以及何时需要重生成
go.sum 是模块校验和文件，记录每个依赖模块的哈希值，用于防止依赖篡改。它由 Go 工具链自动生成和维护，手动修改会导致 go build 报错 checksum mismatch。
- 当你执行
go get、go mod tidy或首次go build时，Go 自动更新go.sum - 若因网络问题导致
go.sum中某行缺失或损坏，不要删掉整行，而应运行go mod download -dirty或临时设置GOPROXY=direct后再go mod tidy - 团队协作中，
go.sum必须提交进 Git —— 它不是“缓存”，而是安全契约的一部分
replace 和 exclude 的典型使用场景与风险
replace 用于临时覆盖依赖路径（如本地调试、fork 修复），exclude 则强制忽略某个版本（极少用，仅限已知严重 bug 且无替代方案）。
