replace没删干净会导致ci构建拉错代码，因其不会被go mod tidy自动移除，且go.sum会锁住旧校验和，必须手动删除go.mod中replace行、清理modcache并重建go.sum。
go.mod 里 replace 没删干净，发布时拉错代码
模块发布失败，CI 构建产物中仍含本地路径代码，八成是 go.mod 里的 replace 声明没清理。它不会随 go mod tidy 自动移除，也不会报错，只在构建时静默生效——你本地能跑通，别人 clone 下来就编译失败或行为异常。
-
replace是开发期临时映射，不是依赖声明，go mod tidy完全无视它 - 检查方式：直接打开
go.mod文件，搜replace关键字；别信go list -m all输出，它不显示 replace 行 - 若 replace 指向本地绝对路径（如
replace example.com/lib => /Users/me/src/lib），发布前必须删掉整行，否则别人构建时会因路径不存在而报cannot find module providing package - 若 replace 指向 fork 分支（如
replace example.com/lib => github.com/you/lib v1.2.3），确认该 tag 确实已推送到 GitHub 且可公开访问；否则需先git push --tags，再删 replace
replace 被 go.sum 锁住，改了 go.mod 也不生效
go.sum 文件会记录 replace 后模块的校验和，即使你删了 go.mod 中的 replace 行，只要 go.sum 里还存着旧 checksum，go build 就仍按旧逻辑加载——表现为：删完 replace 后 go list -m example.com/lib 显示版本没变，或 go mod graph 里仍有本地路径节点。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 执行
go mod tidy不会更新go.sum中 replace 相关条目，必须手动清理 - 安全做法：删掉
go.mod中 replace 行后，立刻运行go clean -modcache，再go mod download重新拉取真实远程模块 - 更彻底：删
go.sum全部内容，再go mod tidy重建（前提是确保go.mod已无 replace，且网络可达） - 注意：若项目用了私有模块，删
go.sum后首次go mod tidy可能卡住，需确认GOPROXY和GOPRIVATE设置正确
CI 流水线里 replace 残留引发版本漂移
本地开发用 replace 调试，但 CI 脚本里忘了清除，导致每次构建都从本地路径 copy 代码——这不是缓存问题，是环境变量或脚本硬编码导致的。典型现象：同一 commit，在不同 runner 上构建出不同二进制，sha256sum 对不上。
- 检查 CI 脚本是否执行了
go env -w GOPATH=...或export GOCACHE=...，这些可能让go mod复用旧缓存中的 replace 映射 - CI 中应显式禁用 replace：在
go build前加go env -w GOSUMDB=off并配合go clean -modcache，避免任何缓存干扰 - 更稳妥：CI 构建前插入校验步骤，比如
grep -q "replace" go.mod && echo "ERROR: replace found in go.mod" && exit 1 - GitHub Actions 用户注意：
actions/setup-go默认不清理go.sum，需手动加rm go.sum步骤（除非你明确需要复用校验和）
replace 指向未提交代码，本地能跑线上挂
replace 到本地未 git add 或未 git commit 的修改，会导致 go build 成功但发布后功能缺失——因为别人拉的是 git 历史版本，没有你的脏修改。
- 验证方法：进 replace 指向的本地目录，执行
git status；若有 untracked 或 modified 文件，必须先提交或 revert - 临时调试建议用
go mod edit -replace动态添加，而非直接编辑go.mod，避免误提交 - 上线前必做：在 replace 目录下运行
git diff HEAD，确保输出为空；再回到主项目执行go mod tidy，确认go.mod中 replace 行已移除 - 团队协作时，replace 应只用于指向已发布的 fork tag，严禁指向本地 dirty tree
go.mod 里、锁在 go.sum 中、又活在 CI 的某个 shell 变量里——三处任一遗漏，发布就不可信。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
