远程分支“看不见”等问题主因是本地未获取引用信息，根源在fetch规则限制、tls握手失败、ssh权限/端口问题或dns解析异常，需按dns→连通性→协议→引用同步逐层排查。
远程分支“看不见”、git pull 报 couldn’t find remote ref、git branch -r 列不出目标分支——这些问题 90% 不是远程仓库没分支，而是你本地根本没拿到它的引用信息，根源在 fetch 行为失效或协议层被阻断。
git fetch origin 没反应？先确认 fetch 规则是否被锁死
很多项目用精简 clone 或手动改过配置，导致 .git/config 里只写了单一分支的 fetch 规则，比如：
fetch = +refs/heads/main:refs/remotes/origin/main
这种写法会让 git fetch origin 完全忽略 dev、feature/* 等其他分支。必须显式支持通配符才能拉全：
- 查当前规则：
git config --get-all remote.origin.fetch - 若输出不是
+refs/heads/*:refs/remotes/origin/*，补上：git config --add remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*" - 再执行
git fetch origin，然后git branch -r | grep your-branch看是否出现
HTTPS 协议下卡在连接或报 TLS 错误？别急着关 sslVerify
fatal: unable to access 'https://...': SSL certificate problem 或 ssl3_get_record: wrong version number 这类错误，大概率是企业中间人代理、老旧 OpenSSL 或服务端 TLS 版本升级导致的握手失败。
- 禁用验证（
git config --global http.sslVerify false）等于把密码明文发出去，尤其 HTTPS 账号密码认证时极其危险 - 正确做法：导出公司/代理的根证书为 PEM 文件，然后指定路径：
git config --global http.sslCAInfo /path/to/company-ca.pem - 验证服务器支持的 TLS 版本：
openssl s_client -connect git.example.com:443 -tls1_2，失败再试-tls1_3 - 若代理是罪魁祸首，临时清空：
git config --global --unset http.proxy和git config --global --unset https.proxy
SSH 方式 Permission denied (publickey)？端口和权限比密钥本身更常出问题
很多人反复加密钥、重试 ssh -T git@host，却忽略两个硬性前提：
- 私钥文件权限必须是
600：chmod 600 ~/.ssh/id_rsa，OpenSSH 会直接拒载 644 或更宽松权限的密钥 - 22 端口不一定通：企业网、校园网、某些云主机默认屏蔽 22，用
nc -zv git.example.com 22测试连通性；不通就换 HTTPS 协议，或联系网络管理员放行 - 公钥是否粘贴完整？GitLab/GitCode 等平台不接受 GitHub CLI 自动生成的密钥格式，也拒绝带多余空格或换行的文本
DNS 解析失败导致 fetch 全面瘫痪？Git 不走系统代理是关键盲区
Could not resolve host 或 unable to access 'https://': Could not resolve host，说明 Git 根本没走到 HTTP 层，卡在域名解析阶段。而很多人误以为“浏览器能打开网页，Git 就该没问题”，这是错的。
- Git 默认不走系统代理，也不读取浏览器 DNS 设置；必须单独验证：
nslookup git.example.com（Windows）或dig git.example.com +short（macOS/Linux） - 若返回
server can't find，立刻换公共 DNS 测试：nslookup git.example.com 8.8.8.8 - 检查
/etc/hosts（macOS/Linux）或C:\Windows\System32\drivers\etc\hosts（Windows），删掉可能存在的错误映射行 - 公司内网常见情况：域名仅内网 DNS 可解，切手机热点一试便知
真正难排查的从来不是命令怎么敲，而是你不知道该信哪一层——DNS、SSH 端口、fetch 规则、TLS 握手、证书链，每一层都可能静默失败。最稳妥的做法是按「DNS → 连通性 → 协议 → 引用同步」顺序逐层验证，跳过任意一层，都可能把 5 分钟能解决的问题拖成半天。
