go get 必须用 @ 显式指定分支名，如 go get example.com/repo@main；不加 @ 默认拉 main/master 最新提交，但 go.mod 中记录为基于时间戳和 commit hash 的伪版本而非分支名。
go get 时如何指定 Git 分支而不是 tag 或 commit
Go 模块默认优先使用 latest tagged version，若目标模块尚未打 tag 或你明确需要某个开发中分支（如 main、dev），直接 go get example.com/repo 不会拉取分支。必须显式告诉 Go “我要这个分支”，否则它可能缓存旧版本或报 no matching versions。
正确做法是用 @ 后缀加分支名：
go get example.com/repo@main go get example.com/repo@dev
注意：@ 后不加 refs/heads/，也不加 origin/ —— Go 的解析器只认裸分支名或 commit hash 或语义化版本。
- 分支名区分大小写，
@Master和@master可能指向不同内容（取决于远端实际命名） - 如果分支名含斜杠（如
feature/login-flow），需 URL 编码斜杠为%2F：go get example.com/repo@feature%2Flogin-flow - 执行后，
go.mod中该依赖行会变成类似example.com/repo v0.0.0-20240520142231-8a1f2b3c4d5e的伪版本，不是branch=main这种可读标记
为什么 go.mod 里显示的是伪版本而非 branch 名
Go 模块系统设计上不存储“分支”这种非固定引用，因为分支内容会变，违反模块不可变性原则。所以 go get @main 实际做的是：先 fetch 远端，找到 main 当前 HEAD 对应的 commit，再生成一个基于时间戳和 commit hash 的伪版本号（v0.0.0-yyyymmddhhmmss-commit）写入 go.mod。
这意味着：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 下次
go build不会自动更新到main新提交 —— 除非你再次go get @main -
go list -m -u all不会提示“有新分支可用”，只对 tagged version 做升级检查 - 如果你希望持续跟踪某分支最新，CI 或本地脚本中需定期
go get @branch && go mod tidy
用 replace + git clone 临时覆盖分支（适合调试）
当你要频繁修改依赖代码，或目标分支未公开、需走私有 Git 地址时，replace 更灵活：
replace example.com/repo => ../local-fork/repo
但要注意路径必须是绝对路径或相对于 go.mod 的相对路径；且该本地目录必须是一个合法 Git 仓库，并已 checkout 到目标分支（如 git checkout dev）。
- 执行
go mod tidy后，Go 会从本地路径读取 module path 和 version（仍生成伪版本，但指向你本地 commit） - 如果本地 repo 没有
go.mod，Go 会尝试按 legacy GOPATH 方式解析，容易出错，务必保证本地有正确go.mod - 上线前必须删掉
replace行并重新go get @branch，否则构建环境找不到../local-fork/repo
常见错误：go get @branch 失败的几个典型原因
最常遇到的不是语法错，而是底层 Git 协议或权限问题：
-
invalid version: unknown revision main：远端仓库没叫main的分支，或 Git 服务器（如自建 Gitea）未开启advertiseRefs，导致 Go 无法列出分支 -
unable to detect version: module github.com/xxx/yyy: reading https://proxy.golang.org/...: 404 Not Found：GOPROXY 拦截了请求，但代理不支持分支查询 —— 此时需临时关 proxy：GOPROXY=direct go get @main -
fatal: unable to access 'https://...': Could not resolve host：私有域名未被 Go 的 Git 客户端识别，需配置git config --global url."https://user:token@github.com/".insteadOf "https://github.com/"
分支不是“稳定锚点”，强制指定分支本质是在松动模块版本契约。生产环境尽量避免长期依赖未发布分支，尤其当多个服务共享同一依赖时，伪版本不一致极易引发隐性不兼容。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
