go get 拉取分支必须用 @ 显式标注，空格分隔会报 unknown revision 错误；正确格式为 go get github.com/user/repo@branch-name，分支名含斜杠时需加英文双引号包裹。
go get @branch 语法必须带 @，空格分隔会失败
直接写 go get github.com/user/repo branch-name 肯定报错：unknown revision branch-name。Go 不识别空格分隔的分支名，只认 @ 后缀语法。这是最常踩的坑，尤其从 Git 命令习惯迁移到 Go 模块时容易忽略。
正确写法只有这一种形式：go get github.com/user/repo@branch-name。注意：
- 分支名区分大小写，
@main和@master是两个不同分支 - 如果分支名含斜杠（如
feature/login-flow），必须用英文双引号包裹整个参数：go get "github.com/user/repo@feature/login-flow"，否则 shell 会把/login-flow当作路径解析 - 该分支必须在远程仓库存在，且其 HEAD 提交对应的 commit 必须有合法的
go.mod文件（module 名需匹配导入路径）
分支没打 tag 且无 go.mod → go get 直接失败
拉取分支失败时常见错误信息是：missing go.sum entry 或 unknown revision。根本原因不是网络或权限问题，而是该分支 HEAD 缺少 go.mod，或 go.mod 中的 module 声明与你 import 的路径不一致。
例如你 import "github.com/user/repo"，但分支里 go.mod 写的是 module github.com/user/repo/v2，Go 就会拒绝识别——它严格按 module 路径匹配。
验证方式很简单：
- 打开浏览器访问
https://github.com/user/repo/tree/branch-name/go.mod，确认文件存在且内容合理 - 检查该
go.mod第一行是否为module github.com/user/repo（完全一致，不含/v2等后缀） - 如果只是临时开发分支、还没合入主干，建议手动在该分支补一个最小
go.mod：module github.com/user/repo go 1.21
go.mod 已有更高版本 → 降级分支会被拒绝
执行 go get github.com/user/repo@fix-bug-branch 却没生效？先运行 go list -m github.com/user/repo 看当前记录的版本。如果显示 v2.0.0+incompatible，而你想切回 @fix-bug-branch（其底层 commit 对应 v1.x），Go 默认拒绝降级。
这不是 bug，是模块安全策略：防止意外引入低版本导致行为退化。解决方法只有两个：
- 显式删除旧依赖再拉新分支：
go mod edit -droprequire=github.com/user/repo→go get github.com/user/repo@fix-bug-branch - 或一步到位：
go mod edit -require=github.com/user/repo@fix-bug-branch→go mod tidy - 执行完务必验证：
go list -m github.com/user/repo输出应含fix-bug-branch字样，而非版本号
私有仓库 + 分支拉取失败 → 检查 GOPRIVATE 和认证
对 gitlab.example.com/internal/pkg@dev 这类私有地址，即使加了 @dev，仍可能卡在 401 Unauthorized 或 fallback 到 proxy 报 not found。
关键点在于环境配置：
-
GOPROXY默认会尝试走proxy.golang.org，必须跳过私有域：go env -w GOPRIVATE=gitlab.example.com - 确保 Git 凭据可用：支持 SSH（
git@gitlab.example.com:...）或 HTTPS + token（需配置~/.netrc或 Git credential helper） - 如果用 SSH，注意
go get无法自动读取ssh-agent的 key，得确认ssh -T git@gitlab.example.com能通
分支拉取不像 tag 那样被广泛缓存，每次都是直连远程 Git 服务，所以网络链路、认证、权限三者缺一不可——这点比拉 @v1.2.3 更敏感。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
