go.mod是模块的权威契约文件：module声明唯一路径，go指定最低go版本，require列出直接依赖及版本，replace/exclude为例外规则，indirect标记间接依赖，所有行均影响构建与运行。
go.mod 文件里每一行都在干什么
go.mod 不是配置清单，而是模块的“契约文件”：它声明你**明确接受**的依赖版本、Go 语言最低要求、以及你愿意打破规则的例外。任何一行都可能影响构建结果或运行时行为。
常见误读是把 require 当成“我要用这个库”，其实它表示“我直接 import 了这个路径下的包，且至少需要这个版本”。如果某依赖被其他依赖间接拉入，但你没直接 import 它，Go 就会标上 // indirect —— 这类条目不能手动删，go mod tidy 会根据实际 import 自动增删。
-
module必须与代码仓库地址一致（如github.com/user/project），否则别人import你的包时会失败 -
go行不是目标 Go 版本，而是“此模块支持的最低 Go 版本”，低于该版本的go build会报错 -
replace只在本地调试有效，CI 环境不会自动继承；若指向相对路径（如./local-mux），必须确保该路径存在且含有效go.mod -
exclude不阻止下载，只阻止 Go 在 MVS 计算中考虑该版本；它解决的是“某个版本有严重 bug，但又不能立刻升级”的临时规避
为什么 go.sum 文件不能删，也不能手改
go.sum 是模块校验和的快照，不是日志也不是缓存。它记录每个依赖模块及其所有子依赖的 zip 文件哈希值，用于验证下载内容是否被篡改或损坏。
删除 go.sum 后首次 go build 或 go mod download 会重新生成它，但此时无法保证和团队其他人一致 —— 因为不同时间点的代理返回的模块压缩包可能不同（尤其当上游发布者重推同版本 tag 时）。
- 手动修改
go.sum会导致go build报错：verifying github.com/xxx@v1.2.3: checksum mismatch - 若要更新校验和，应运行
go mod download或go mod tidy，而非编辑文件 - 私有模块若未配置
GOSUMDB=off或自建 sumdb，go.sum会因无法验证而失败
GO111MODULE=on 和 GOPROXY=https://proxy.golang.org 的真实作用
这两个环境变量不是“可选优化”，而是现代 Go 工程的基础设施开关。不设它们，项目大概率在 CI 或新机器上直接失败。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
GO111MODULE=on 强制启用模块模式，绕过 auto 模式下对 GOPATH 的隐式判断 —— 尤其当你项目路径恰好落在旧 GOPATH/src 下时，auto 会退化回 GOPATH 模式，导致 go.mod 被忽略。
GOPROXY 决定依赖从哪下载。默认 https://proxy.golang.org 在国内常超时或被重置，必须显式设为可用地址（如 https://goproxy.cn 或公司内网代理），否则 go get 卡住、go mod tidy 失败。
- 设置方式推荐写入 shell 配置：
export GO111MODULE=on和export GOPROXY=https://goproxy.cn,direct -
direct在 proxy 列表末尾表示：对私有域名（如git.internal.company.com）跳过代理，直连 - 若用
replace指向本地路径，GOPROXY不影响该替换，但会影响其他依赖的下载源
require 中的版本号格式到底怎么写才安全
写死版本（如 v1.8.0）最常见，但不是最稳。Go 的 MVS 算法只保证“满足约束的最小版本”，而约束来自所有 require 行 —— 所以单个 require 的写法，要结合项目整体依赖结构来看。
真正危险的是模糊写法：>=v1.5.0 看似灵活，实则让 MVS 有机会选到未来发布的 v1.99.0，而该版本可能破坏你的代码；<v2.0.0> 在主版本升级时容易漏掉 v2+ 的 breaking change。</v2.0.0>
- 生产项目一律用精确版本（
v1.8.0），由go get xxx@v1.8.0或go mod tidy自动写入 - 仅在实验性项目或脚手架中用
latest（即go get xxx@latest），但需立刻git commit锁定结果 - 主版本变更（如从
github.com/foo/bar到github.com/foo/bar/v2）必须显式写进 import 路径和require，Go 不会自动升级 v1 → v2 - 若依赖项本身没有打 tag，Go 会 fallback 到 pseudo-version（如
v0.0.0-20240101120000-abcdef123456），这种版本不可靠，应避免长期使用
replace 路径拼错，或 GOPROXY 少了个 direct，就足以让整个 pipeline 卡在依赖环节。
