GitLab PAT必须勾选api权限且GOPROXY需含GitLab Go Proxy地址，否则go mod tidy会报401或404；自签名证书需通过CERT_FILE环境变量配置，GoLand不提供UI设置入口。
GitLab 个人访问令牌（PAT）必须带 api 权限
GoLand 本身不管理 GitLab 凭证，它依赖 go 命令行工具拉取私有模块，而 go 在访问 HTTPS 私有仓库时，只认 HTTP Basic Auth（用户名 + 令牌），不支持 SSH 或 OAuth2。所以你不能用 GitLab 账号密码登录，也不能复用 Git 配置里的 git config --global credential.helper。
必须创建一个带 api scope 的个人访问令牌（Personal Access Token），步骤如下：
- 右上角头像 → Settings → Access Tokens
- 填写名称（如
go-mod-pull），设置有效期（建议不设或设长些，避免频繁更新） -
务必勾选
api—— 其他权限（如read_repository）不够，go get会报401 Unauthorized - 生成后立即复制保存，页面刷新后无法再次查看
GOPROXY 必须包含 GitLab Go Proxy 地址
GitLab 从 15.1 版本起默认启用 Go Proxy 功能，但需管理员在服务端开启（Feature.enable(:go_proxy)）。确认你的 GitLab 实例已启用后，才能用 go 直接解析 gitlab.example.com/group/repo 模块路径。
配置代理链顺序很关键：国内用户通常需要组合使用，例如：
立即学习“go语言免费学习笔记（深入）”；
GOPROXY=https://goproxy.cn,https://gitlab.example.com/-/proxy/,direct
注意三点：
用大白话操作当前项目的 Git/GitHub——配置 GitHub（装 gh CLI + 登录 + 建仓库）、备份、拉取下载、查询历史、回滚代码、管理分支。当用户用日常语言表达 git 意图时触发（例如"git备份一下""git下载项目""git拉下来""git看看我改了啥""git回退到上一个版本""git新建个分支搞新功能""git合并到主分支""git
-
https://gitlab.example.com/-/proxy/末尾的斜杠 不能省略，否则go会拼错 URL 导致 404 - 多个代理用英文逗号分隔，
direct放最后兜底，否则私有模块会跳过 GitLab 直接走公共镜像 - 如果 GitLab 启用了自签名证书，
go默认拒绝连接，需配合CERT_FILE环境变量（见下一条）
CERT_FILE 环境变量是解决 x509 错误的唯一有效方式
当你看到类似 x509: certificate signed by unknown authority 报错，说明 go 进程没加载你的内部 CA 证书 —— GoLand 的 UI 不提供证书路径配置入口，改设置无效。
正确做法是在 GoLand 启动前注入环境变量：
- Windows：系统环境变量中新增
CERT_FILE，值为完整 PEM 路径（如D:\certs\gitlab-ca.crt），然后重启 GoLand - macOS/Linux：在终端启动 GoLand 前执行
export CERT_FILE=/path/to/gitlab-ca.crt && goland - 若用 Run Configuration 执行
go run，需在该配置的Environment variables中手动添加CERT_FILE=...
验证是否生效：在 GoLand Terminal 中运行 go env -w GODEBUG=httpproxy=1，再试 go list -m gitlab.example.com/group/repo，看日志里是否还出现证书错误。
go mod tidy 会触发凭证校验，但不会缓存失败结果
go mod tidy 是实际检验配置是否成功的操作，它会尝试解析所有 require 行中的模块，包括私有 GitLab 地址。常见现象：
- 第一次运行卡住几秒后报
unrecognized import path或403 Forbidden→ 令牌没权限或没配GOPROXY - 报
401 Unauthorized→ 令牌失效、被删、或未勾选api - 报
no matching versions for query "latest"→ 模块路径写错（如漏了v0.0.0-xxx后缀），或 GitLab 项目没打 tag / 没启用 Go modules 支持
注意：go mod tidy 失败后不会把错误“记下来”，下次仍会重试；也不会自动 fallback 到 git clone，它只走 GOPROXY 流程。所以调试时别反复删 go.sum，先确保网络和凭证通。
最常被忽略的是 GitLab 实例侧的 Go Proxy 开关状态和 PAT 的 api 权限 —— 这两个点不满足，其他配置全对也白搭。
