Git 报错 fatal: unable to access repository 连接超时通常由网络不通、代理配置错误或仓库地址错误引起。优先检查本地网络连接和 Git 代理设置，再尝试切换 HTTPS 与 SSH 协议。

命令速用版

以下命令用于快速清除代理配置并测试连接，适用于大多数因代理导致的超时场景。

git config `--global` `--unset` http.proxy
git config `--global` `--unset` https.proxy
git clone <仓库地址>

若使用 SSH 协议，测试 SSH 连接命令如下：

ssh -T git@github.com

为什么会这样

连接超时的本质是 Git 客户端发出的网络请求在规定时间内未收到服务器响应。常见原因包括本地网络断开、DNS 解析失败、公司防火墙拦截、Git 配置了无效的代理服务器，或者远程仓库服务暂时不可用。HTTPS 协议依赖 443 端口，SSH 协议依赖 22 端口，任一端口被阻断都会触发该报错。

分步处理

按以下顺序操作，每步完成后尝试再次执行 Git 命令，若问题解决则无需继续后续步骤。

步骤 1：检查基础网络连通性
在终端执行 ping 命令测试域名解析和网络可达性。若 ping 不通，说明本地网络或 DNS 有问题，需先修复网络。

ping github.com

步骤 2：清除 Git 代理配置
很多超时是因为之前配置过代理但当前网络环境不需要。执行以下命令清除全局代理设置。

git config `--global` `--unset` http.proxy
git config `--global` `--unset` https.proxy

若只需针对特定仓库取消代理，去掉 `--global` 参数并在仓库目录下执行。

步骤 3：切换远程协议
若 HTTPS 超时，尝试切换为 SSH 协议，反之亦然。HTTPS 适合防火墙严格环境，SSH 适合频繁推送场景。

git remote set-url origin git@github.com:username/repo.git

步骤 4：检查 SSH 密钥权限
若使用 SSH 协议，确保私钥文件权限正确，否则 SSH 连接会被拒绝。

chmod 600 ~/.ssh/id_rsa

怎么验证是否生效

执行 fetch 命令并开启详细输出，观察是否仍有超时错误。若显示 remote: Counting objects 则连接成功。

git fetch `--verbose`

检查远程地址配置是否正确，确认协议头是否符合预期。

git remote -v

常见坑

1. 全局代理残留：取消代理后若仍报错，检查环境变量中是否设有 HTTP_PROXY 或 HTTPS_PROXY，这些变量优先级高于 Git 配置。
2. SSH 密钥权限：私钥文件权限若为 644 或更开放，SSH 客户端会拒绝使用该密钥，导致连接失败。
3. 企业防火墙：部分公司网络禁止外部 SSH 连接，此时必须使用 HTTPS 并配置企业认可的证书或代理。
4. 仓库地址拼写：远程 URL 拼写错误会导致连接到不存在的 host，表现为超时而非明确的 404 错误。

常见问题

HTTPS 和 SSH 哪个更稳定？

取决于网络环境，内网或受限网络通常 HTTPS 更稳，外网频繁操作 SSH 更方便。若 HTTPS 超时，切换 SSH 往往能解决；若 SSH 端口被封，切换 HTTPS 并配置代理可解决。

只有某个仓库报错怎么办？

说明全局网络和配置正常，问题出在该仓库的远程地址或权限。检查该仓库的 git remote -v 地址是否正确，确认是否有访问该仓库的独立权限。

能增加 Git 超时时间吗？

可以，通过配置 http.lowSpeedLimit 和 http.lowSpeedTime 调整，但这只是延缓报错，不能解决网络不通的根本问题。