“unknown revision”报错本质是go模块解析失败，主因有三：git标签缺失v前缀、go.mod中module名与仓库url不一致、v2+版本未同步更新module路径和标签。
go get 报 “unknown revision” 到底在报什么
这不是网络连不上，而是 Go 的模块解析器在告诉你：它找不到匹配的 Git 标签，或者找到了但路径对不上。常见现象是本地 go get git.example.com/mylib@v1.2.0 失败，而 git clone 能成功——说明代码存在，但 Go 不认这个“版本”。
- 标签必须带
v前缀，v1.2.0可以，1.2.0或release-1.2.0不行 -
go.mod里声明的module名必须和仓库 URL 完全一致（协议、域名、路径全部匹配），比如仓库地址是https://git.example.com/team/utils，那go.mod就得写module git.example.com/team/utils - v2+ 版本必须显式加
/v2后缀到 module 路径里，且对应 Git 标签也得是v2.0.0，不能只改标签不改路径
本地开发时怎么安全用 replace 而不埋雷
replace 是调试利器，但也是生产环境的定时炸弹。它只在当前模块生效，下游项目 go get 时完全看不到，也不会进 go.sum，一旦上线就炸。
- 仅限
go.mod开头加，格式为replace example.com/lib => ./local-lib，路径必须是相对路径，不能用../跨出项目根目录 - CI/CD 流程里绝对禁用
replace；构建前跑go mod edit -dropreplace=example.com/lib清掉它 - 想验证本地修改是否真能被下游拉到？删掉
$GOPATH/pkg/mod/cache，再用GO111MODULE=on go get -d example.com/lib@v1.2.0实测拉取
打 tag 前必须确认的三件事
Git tag 不是“发布按钮”，只是给 Go 模块系统一个可寻址的锚点。漏掉任一环节，下游就卡在 no matching versions。
- 确保目标 commit 下，该模块目录（哪怕只是子目录）有独立的
go.mod，且module行与你打算go get的路径一致 - v2+ 版本必须同步改两处：Git tag 名（
v2.0.0）和go.mod中的module路径（加/v2），缺一不可 - 打完 tag 立刻推送到远端：
git push origin v1.2.0；只本地打 tag，Go 依然认为“不存在”
GOPRIVATE 和 GOPROXY 怎么配才不翻车
私有模块最常栽在代理上：要么被公开镜像劫持（返回 404 或旧缓存），要么被自建 proxy 拒绝（默认不代理私有域名）。
-
GOPRIVATE必须设在所有开发者和 CI 环境中，格式如export GOPRIVATE="git.example.com/*,gitee.com/myteam/*"，通配符支持，多个用逗号分隔 - 若用自建
GOPROXY（如 Athens），必须在配置里显式加入allowed规则，否则它会直接拒绝请求，而不是 fallback - CI 中别信
go mod download默认行为；加-x参数看真实 fetch 日志，或先执行go clean -modcache彻底清空干扰
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
