Go 依赖 Git 配置实现模块拉取，需正确设置 GOPRIVATE、Git URL 替换、凭证及 SSH 配置，否则 go mod download 等命令会因认证失败、代理拦截或协议不匹配而卡住或报错。
Go 本身不依赖 Git 运行，但 go get、模块下载、私有仓库拉取等行为会直接调用系统 Git，配置错误会导致 go mod download 失败、go get 卡住或认证拒绝。
Git 配置必须匹配 Go 模块路径与私有域名
Go 模块路径（如 git.example.com/org/repo）会被 go 命令直接映射为 Git URL。若该域名未在 Git 中配置正确协议或凭证，就会失败。
- 确保
git config --global url."https://".insteadOf "git@"已设置（避免 SSH 默认触发但无密钥场景） - 私有 HTTPS 仓库需提前配置凭据：
git config --global credential.helper store，然后首次手动git clone https://git.example.com/org/repo触发存凭据 - 若用 SSH，模块路径必须以
git@git.example.com:org/repo格式书写，且~/.ssh/config中需定义对应 Host 别名与 IdentityFile
go env -w GOPRIVATE=* 是私有模块绕过校验的关键
Go 1.13+ 默认对所有模块启用 checksum 验证和代理转发，未加 GOPRIVATE 的私有域名会被强制走 proxy.golang.org，导致 404 或 403。
从 Git 仓库历史中彻底删除文件
下载
|Git删除了文件，但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息（密码、密钥、token、私钥） - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件
- 运行
go env -w GOPRIVATE=git.example.com,github.company.internal（逗号分隔，不带协议，支持通配符如*.company.internal） - 该设置仅影响校验与代理行为，不影响 Git 实际克隆逻辑——Git 仍按原路径调用
- CI 环境中需在构建前显式执行该命令，或在
.bashrc/setup-env.sh中预设
go mod edit -replace 用于临时覆盖模块源，但不解决根本 Git 配置问题
当某模块无法从原始地址拉取时，-replace 可指向本地路径或另一 Git 地址，但它只是构建期重写 import 路径，不改变 go mod download 对原始源的依赖。
- 示例：
go mod edit -replace github.com/some/lib=../local-lib - 若原始
go.sum条目仍引用不可达地址，go mod tidy会报错；此时需先go env -w GOPROXY=direct再 tidy - 上线前务必删掉
-replace行并验证能否从真实源拉取，否则团队协作时其他人无法复现
真正卡住的往往不是 Go 命令本身，而是 Git 在后台静默失败：比如 SSH agent 未加载、HTTPS 凭据过期、GOPRIVATE 拼写漏点、或公司网络拦截了 git:// 协议。调试时优先看 go list -m all -v 2>&1 | grep -i git 输出的实际 Git 命令和错误行。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
