推荐用 go 命令管理依赖而非手动编辑 go.mod；go get 精准更新单个模块，go mod tidy 自动清理补全依赖，indirect 和 replace 需谨慎处理，go list 和 go mod verify 辅助诊断。
直接编辑 go.mod 文件虽可行，但不推荐作为常规操作；Go 工具链提供了更安全、一致的命令来管理依赖，手动修改容易引发版本冲突、校验失败或构建异常。核心原则是：让 go 命令主导变更，仅在必要时辅助调整。
用 go get 精准更新单个依赖
避免直接改 go.mod 中的版本号。想升级某模块到指定版本，运行：
-
go get example.com/some/pkg@v1.2.3—— 拉取并记录该版本 -
go get example.com/some/pkg@latest—— 升级到最新 tagged 版本 -
go get example.com/some/pkg@master—— 使用特定分支（慎用，无语义版本保障）
执行后，go.mod 自动更新 require 行，go.sum 同步刷新校验和，且会自动清理未引用的间接依赖（除非启用 -u=patch 或 -u）。
用 go mod tidy 清理与补全依赖
这是整理 go.mod 最常用也最可靠的命令。它会：
立即学习“go语言免费学习笔记（深入）”；
- 扫描全部
.go文件，找出实际 import 的模块 - 添加缺失的
require条目 - 移除未被任何代码引用的
require行（包括 indirect 标记的） - 同步更新
go.sum
建议每次增删 import 或重构包结构后都运行一次：go mod tidy。若想强制重新计算所有依赖（比如怀疑缓存异常），可加 -v 查看详细过程。
谨慎处理 indirect 和 replace 语句
indirect 表示该模块未被你的代码直接 import，而是由其他依赖引入。不要手动删掉它——除非你确认整个依赖树都不再需要它（此时 go mod tidy 会自动移除）。
replace 用于本地开发调试或临时覆盖远程模块，例如：
replace github.com/abc/lib => ./local-lib
这类语句应保留在 go.mod 中便于协作，但上线前建议移除或改用 go mod edit -dropreplace 清理。
检查与验证依赖状态
运行以下命令快速诊断常见问题：
-
go list -m all—— 列出当前解析出的所有模块及其版本 -
go list -u -m all—— 显示可升级的模块（含新版本提示） -
go mod verify—— 校验go.sum是否与下载内容一致 -
go mod graph | grep xxx—— 查看某模块被谁依赖，辅助分析冗余来源
发现重复或冲突版本时，优先通过 go get 统一指定版本，而非手动编辑 go.mod 强行覆盖。
