容器内go mod tidy读不到宿主机replace路径，根本原因是docker未挂载对应本地路径，导致../bar等相对路径在容器中不存在；应改用远程tag替换或统一goproxy/goprivate配置。
容器内 go mod tidy 读不到宿主机的 replace 路径
常见现象是：本地开发时用 replace github.com/foo/bar => ../bar 指向同目录下的子模块，go build 正常；但一进 Docker 构建或运行，就报 cannot find module providing package 或 no matching versions for query "latest"。
根本原因是 Docker 默认只挂载项目根目录（比如 /app），而 ../bar 在容器里根本不存在——宿主机上的上层目录没被映射进来。
- 别在
Dockerfile中直接COPY . /app后就跑go mod tidy，此时replace指向的本地路径已失效 - 若必须用本地 replace，得把对应路径也挂载进容器：
docker run -v $(pwd)/../bar:/app/../bar ...，但路径写法极易出错且不可移植 - 更稳妥的做法是：CI/CD 或容器场景下，禁止提交带本地路径的
replace；改用 fork + tag + 远程 replace，例如replace github.com/foo/bar => github.com/yourname/bar v0.1.0
go.sum 文件在宿主机和容器间校验失败
现象是：宿主机 go mod tidy 成功，go.sum 有内容；容器里执行 go build 却报 verifying github.com/xxx@v1.2.3: checksum mismatch。
本质是 go.sum 记录的是模块内容的校验和，而不同环境（尤其是 GOPROXY 设置不一致）可能拉到不同源的同一 tag —— 比如宿主机走公司私有 proxy，容器默认走 proxy.golang.org，哪怕 tag 相同，二进制内容也可能因重打包或镜像同步延迟而不同。
- 统一配置
GOPROXY：容器启动前设环境变量GOPROXY=https://goproxy.cn,direct或你司私有地址，确保和宿主机一致 - 私有仓库必须配
GOPRIVATE：否则 Go 会绕过校验直连，导致go.sum缺失对应条目，后续校验失败 - 不要忽略
go.sum提交：它不是“可选文件”，是生产构建一致性的关键凭证
vendor 目录挂载后 go mod 行为异常
有些团队习惯 go mod vendor 后把整个 vendor/ 目录挂进容器，以为能离线构建。结果却出现 require ... // indirect 消失、依赖版本回退、甚至 go list -m all 输出变少。
这是因为 Go Modules 在检测到 vendor/ 目录存在时，会自动启用 -mod=vendor 模式——它只读 vendor/modules.txt，完全无视 go.mod 里的 replace 和 exclude，也不验证 go.sum。
- 容器内构建时，要么彻底不用
vendor（推荐），要么确保vendor/modules.txt是用当前go.mod生成的，且与之严格同步 -
go mod vendor前先go mod tidy，否则modules.txt可能漏掉间接依赖 - CI 镜像中若预装了 vendor，运行前务必
rm -rf vendor && go mod tidy再构建，避免残留污染
多阶段构建中 GOPATH/pkg/mod 缓存失效
写 Dockerfile 时常用 COPY go.mod go.sum . → go mod download → COPY . . 来利用 layer 缓存。但有时发现第二步 go mod download 仍重新下载所有依赖，缓存没生效。
问题往往出在 go.mod 或 go.sum 文件本身被编辑器或 Git 自动转换了换行符（CRLF vs LF），导致 hash 不匹配；或者 go mod download 执行时环境变量（如 GOPROXY）和宿主机不一致，拉取源不同。
- 确保
.gitattributes中声明*.mod text eol=lf和*.sum text eol=lf，防止 Windows 换行符污染 - 多阶段构建中，
go mod download步骤显式指定GOPROXY和GOPRIVATE，和 CI 环境保持一致 - 别依赖 “宿主机 mod cache 自动复用”：容器内
$GOPATH/pkg/mod是干净的，go mod download必须独立完成，缓存只靠 Docker layer
go list -m all 和 go mod graph 输出比反复改 Dockerfile 更有效。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
