go mod tidy卡在git ls-remote是因git命令未获取凭据，需先确保git ls-remote -q https://gitlab.example.com/group/project.git成功；关键在于正确配置.netrc（权限600、路径准确、填PAT）、GOPRIVATE与GOPROXY=direct同时设置，并保持模块路径与git URL域名完全一致。
go mod tidy 卡在 git ls-remote 就是认证没走通
这不是 Go 本身的问题，而是 git 命令根本没拿到凭据。Go 调用 git ls-remote 时，如果 HTTPS URL 对应的域名没配好凭据，就会卡住或报 exit status 128、401 Unauthorized。关键点在于：Go 不自己管认证，它只把模块路径转成 git URL，然后甩给系统 git 命令执行。
验证最直接：手动跑一遍等效命令：git ls-remote -q https://gitlab.example.com/group/project.git
如果这行命令也失败（提示需要用户名/密码），那 go mod tidy 必然失败——先修 git，再修 Go。
- 确保
gitlab.example.com和go.mod里声明的模块前缀完全一致（比如module gitlab.example.com/group/project） - 不要用子路径（如
https://example.com/gitlab），machine只写根域名 - Windows 下必须用
%USERPROFILE%/_netrc，不是.netrc
HTTPS 场景下 .netrc 权限和格式错一个就静默失效
.netrc 看似简单，但 git 对它极其挑剔：路径错、权限错、空行、注释、多空格，全都会被忽略，且不报错——你只会看到“401”或“卡住”，完全不知道是 .netrc 没生效。
正确写法只有这一种（Linux/macOS）：
machine gitlab.example.com<br>login your_username<br>password your_personal_access_token
- 文件路径必须是
$HOME/.netrc，不能是~/dotfiles/.netrc或其他位置 - 权限必须是
600：chmod 600 ~/.netrc，ls -l ~/.netrc确认输出含-rw------- -
password字段填 GitLab 的 Personal Access Token（勾选read_repository），不是登录密码 - 不允许
# 注释、不允许空行、不允许machine后多空格
GOPRIVATE 和 GOPROXY=direct 必须同时设，缺一不可
只设 GOPRIVATE=gitlab.example.com/* 不够。Go 会跳过校验，但默认仍走 GOPROXY（比如 https://goproxy.cn），而代理不会转发你的 .netrc 或 git 凭据，结果还是 403 或 404。
立即学习“go语言免费学习笔记（深入）”；
必须让 Go 绕过代理，直连 Git 服务器：go env -w GOPROXY=direct
-
GOPRIVATE控制“是否绕过代理 + 是否跳过 checksum 校验”，GOPROXY=direct控制“是否真走直连” - 多个私有域用逗号分隔，无空格：
go env -w GOPRIVATE="gitlab.example.com/*,github.com/my-team/*" - 如果用了自签名证书，还得加：
go env -w GOINSECURE="gitlab.example.com" - 检查是否生效：
go env GOPRIVATE GOPROXY应同时输出你设的值
SSH 方式比 HTTPS 更稳定，但路径和配置必须对齐
如果你的 GitLab 支持 SSH，且已配好密钥，这条路反而更少踩坑——不用管 .netrc 权限，也不用担心 token 过期。
但前提是三者完全一致：
① go.mod 中模块路径写成 SSH 格式：module git@gitlab.example.com:group/project
② git config 做协议重写：git config --global url."git@gitlab.example.com:".insteadOf https://gitlab.example.com/
③ ssh -T git@gitlab.example.com 能成功返回欢迎信息
- SSH URL 必须以
git@开头，不能混用 HTTPS 路径 -
~/.ssh/config可简化连接：Host gitlab.example.com\n User git\n IdentityFile ~/.ssh/id_rsa - CI 环境中记得
chmod 600私钥文件，并用ssh-add加载
真正容易被忽略的是：Git 层认证和 Go 层配置是两层独立逻辑，GOPRIVATE 不等于“自动登录”，.netrc 不等于“全局生效”。每次失败，先用 git ls-remote 复现，再逐层关掉代理、检查路径、验证 token，比反复改 Go 配置高效得多。
