go get拉取分支卡在resolving import path的根本原因是模块代理不支持非语义化分支解析，应优先用commit hash替代；若必须用分支，需确保有轻量tag或配置GOPROXY=direct，replace生效需路径一致且go.mod存在。
go get 拉取指定分支时卡在 resolving import path
这是最典型的死锁表现：命令长时间无响应，go mod tidy 或 go get 无法完成，CPU 占用低，网络连接看似正常但实际卡在模块解析阶段。根本原因不是网络慢，而是 Go 的模块代理（如 proxy.golang.org）默认不支持直接拉取非语义化版本的分支（比如 main、dev、feature/login），它会尝试解析该分支对应的 latest tag，而很多私有库或未打 tag 的分支根本没提供可映射的版本，导致 resolver 循环等待超时。
- 不要用
go get github.com/user/repo@branch-name直接拉分支 —— 这是触发死锁的高频操作 - 优先改用
go get github.com/user/repo@commit-hash，commit 哈希是确定性标识，代理能直接命中，不触发版本解析 - 如果必须用分支名，先确认该分支在远程仓库中至少有一个轻量 tag（哪怕只是
v0.0.0-20240501123456-abcdef123456格式），否则代理无法 fallback
私有仓库 + GOPRIVATE 配置后仍卡住
设置了 GOPRIVATE=github.com/internal/* 后依然卡在 resolving，大概率是因为 Go 没跳过代理去直连，而是把请求发给了 proxy.golang.org，而代理拒绝转发私有域名请求，返回 403 或空响应，客户端误判为“网络不可达”并重试，形成假死。
- 检查
go env GOPROXY是否包含direct—— 必须显式加上，例如：export GOPROXY=https://proxy.golang.org,direct -
GOPRIVATE只控制是否绕过代理，不控制是否启用 direct fallback；缺direct就等于白配 - 若使用企业级代理（如 Athens），确保其配置允许代理私有域名，或直接禁用代理：
export GOPROXY=off（仅限可信内网）
go.mod 中 replace 指向本地路径却仍尝试拉远程分支
你写了 replace github.com/user/repo => ../repo，但执行 go build 时还是报错 “cannot find module providing package”，说明 replace 没生效。常见原因是 replace 被 go.sum 或缓存干扰，或者模块路径与 replace 声明不完全一致（大小写、拼写、vendor 路径等）。
- 运行
go mod edit -replace=github.com/user/repo=../repo确保写入的是绝对路径或相对于当前模块根目录的正确相对路径 - 删掉
go.sum并执行go mod tidy—— 缓存的校验和可能锁定旧的远程依赖，阻断 replace 生效 - 确认
../repo下有有效的go.mod文件，且其module行声明的路径与 replace 左侧完全一致（包括协议前缀、大小写）
使用 git+ssh 协议拉取分支时 Permission denied (publickey)
当用 go get git@github.com:user/repo@dev 这类 ssh 地址时，报错 Permission denied (publickey)，不是权限问题，而是 Go 默认只通过 https 协议访问代理，ssh 地址会被忽略或转义失败，最终 fallback 到 https + token 方式，但 token 又没配，就卡死。
立即学习“go语言免费学习笔记（深入）”；
- 禁止在
go get中直接写git@...—— Go 不原生支持 ssh URL 作为模块路径 - 改用 https 形式：
go get github.com/user/repo@dev，再配合git config --global url."git@github.com:".insteadOf "https://github.com/"让 git 底层自动换协议 - 或在
~/.gitconfig中配置 credential helper，让 https 请求携带 token：https://<token>@github.com/user/repo</token>
@branch 在 CI 或多环境部署中不出问题。 
