go拉取gitlab私有仓库失败主因是认证缺失，需配置.netrc（权限600、路径正确、填pat）或git credential.helper，并设goproxy=direct且go111module=on。
Go 无法拉取 GitLab 私有仓库的常见报错
执行 go get 或 go mod tidy 时遇到 401 Unauthorized、403 Forbidden，或者直接卡在 git ls-remote 阶段，基本可以确定是认证失败。GitLab 私有仓库不走 HTTPS 匿名访问，而 Go 的模块代理（如 proxy.golang.org）默认不转发凭据，也不读取系统 git 凭据，必须显式配置。
.netrc 文件必须放在用户主目录且权限严格
.netrc 是 Go（通过底层 git 调用）识别凭据的唯一标准位置之一，但它的路径和权限有硬性要求：
- 路径只能是
$HOME/.netrc（Linux/macOS）或%USERPROFILE%/_netrc（Windows），不能是其他路径，也不能用环境变量覆盖 - 文件权限必须是
600（Linux/macOS）：运行chmod 600 ~/.netrc，否则 git 会静默忽略它 - 内容格式必须严格：每条
machine后紧接login和password，不能有多余空行或注释（# 不被支持）
示例正确内容：
machine gitlab.example.com login your_username password your_personal_access_token
注意：password 字段填的是 GitLab 的 Personal Access Token（需勾选 read_repository），不是账号密码；machine 值必须和 go.mod 中模块路径的域名完全一致（比如模块是 gitlab.example.com/group/project，这里就写 gitlab.example.com）。
立即学习“go语言免费学习笔记（深入）”；
GO111MODULE=on 且 GOPROXY=direct 才能绕过代理走 .netrc
如果启用了模块代理（默认 GOPROXY=https://proxy.golang.org,direct），Go 会优先尝试从代理拉取，而代理不传凭据，.netrc 完全无效。必须强制跳过代理：
- 临时生效：
GOPROXY=direct go mod tidy - 全局设置：
go env -w GOPROXY=direct（推荐，避免每次敲） - 确保
GO111MODULE=on（Go 1.16+ 默认开启，老版本需手动设）
另外，GitLab 实例若启用了子路径（如 https://example.com/gitlab），模块路径和 .netrc 中的 machine 仍只写根域名（example.com），不要带路径。
替代方案：用 git config credential.helper 更可靠
.netrc 简单但易出错——权限不对、路径不对、token 过期都导致静默失败。更健壮的方式是复用 git 自身的凭据管理：
- 先用 git 测试能否拉取：
git clone https://gitlab.example.com/group/project.git，按提示输入 token 作为密码 - 配置 git 记住凭据：
git config --global credential.helper store（明文存~/.git-credentials）或cache（内存缓存） - Go 会自动继承 git 的 credential.helper 行为，无需额外配
.netrc
这个方式不依赖文件权限，支持 token 轮换后重新触发输入，调试时也更容易验证（直接 git ls-remote 就能复现 Go 底层行为）。
真正卡住的地方往往不是语法，而是 .netrc 权限、GOPROXY 开关、以及 GitLab token 的 scope 是否包含 read_repository——这三个点漏掉任何一个，都会让 Go 模块下载彻底静默失败。
