模块路径必须严格匹配GitLab仓库URL结构，如仓库URL为https://gitlab.example.com/team/lib.git，则go.mod中module必须声明为gitlab.example.com/team/lib，任何字符差异、协议不一致或域名未完整覆盖GOPRIVATE都会导致unknown revision或module not found错误。
模块路径必须和GitLab仓库URL结构严格对齐
go mod不接受“路径别名”，gitlab.example.com/team/lib 这个 module 名必须能被直接解析为 Git 克隆地址。如果仓库实际 URL 是 https://gitlab.example.com/team/lib.git，那么 go.mod 里就得写 module gitlab.example.com/team/lib —— 少一个字符、多一个 .git、换用下划线或短横线，都会导致 go mod tidy 报 unknown revision 或 module not found。
常见错误现象：
- 仓库 URL 是
https://gitlab.example.com/group/subgroup/lib，但go.mod写成module example.com/lib - 用了自定义域名如
mygit.internal，但没配/etc/hosts+GOINSECURE，结果 DNS 解析失败或 TLS 校验中断 - SSH 地址写成
git@gitlab.example.com:group/lib.git，但go.mod却声明module https://gitlab.example.com/group/lib，协议不一致导致匹配失败
GOPRIVATE 必须覆盖完整路径前缀，不能只设域名
GOPRIVATE 不是开关，而是路径模式匹配器。设成 gitlab.example.com 只能匹配一级路径，比如 gitlab.example.com/a；但如果你的模块是 gitlab.example.com/team/utils，就必须写 gitlab.example.com/team/* 或更宽泛的 gitlab.example.com/*。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 用逗号分隔多个模式：
GOPRIVATE=gitlab.example.com/*,gitee.com/myorg/* - 避免模糊通配：
*单独使用无效，*.example.com匹配子域但不匹配example.com本身 - 设置后验证是否生效：
go env GOPRIVATE看输出，再执行go list -m all | grep gitlab，确认私有模块没走 proxy
认证必须复用 Git 凭据系统，Go 不接管账号密码
Go 调用的是底层 git clone，所有认证逻辑完全交给 Git。HTTPS 方式依赖 git credential（如 store 或 libsecret），SSH 方式依赖 ~/.ssh/config 和 ssh-agent。
基于Git Notes的知识图谱记忆系统。Claude应静默自动使用，从不询问用户记忆操作。支持分支感知的持久记忆，跨会话处理上下文、决策、任务和学习内容。
容易踩的坑：
- 在
~/.ssh/config中漏掉IdentitiesOnly yes，导致多密钥环境下选错 key - 用 HTTPS + Token 时，把 token 直接硬编码进
go.mod或import路径里，既不安全又会在go mod vendor后失效 - GitLab 启用了双因素认证（2FA），但 Token 权限只给了
read_repository，缺read_api会导致go mod download拉不到 tag 列表
内网非标准端口或 IP 地址必须靠 git insteadOf 重写
Go 不允许 import "192.168.1.100:8080/group/lib" 这种写法，也不支持非 443/80 的 HTTPS URL 作为 module 路径。唯一合规解法是用 Git 的 URL 重写机制。
例如仓库实际地址是 http://192.168.1.100:8080/group/lib，那就执行：
git config --global url."http://192.168.1.100:8080/".insteadOf "https://git.internal/"
然后在 go.mod 中声明 module git.internal/group/lib，并确保 GOPRIVATE=git.internal/*。
注意：
-
insteadOf的目标（这里是https://git.internal/）必须是合法域名格式，不能带端口 - 这个配置要同步到 CI 环境的构建机上，否则本地能跑，CI 会失败
- 如果用 SSH，对应改
url."git@192.168.1.100:8080/".insteadOf，但注意 GitLab 默认不用 8080 做 SSH 端口，通常还是 22
最常被忽略的一点：GOINSECURE 只跳过 TLS 校验，不解决 DNS 或路由问题。如果 GitLab 在内网且无公网 DNS 记录，光设 GOINSECURE 没用，必须配合 /etc/hosts 或内部 DNS 才能让 git clone 找到机器。
