解决 Mac 终端无法从 github 克隆下载问题

解决 Mac 终端无法从 github 克隆下载问题

前言

最近开发的时候由于需要用到 fvm 管理多个多个 flutter 版本、用 nvm 管理多个 node 版本,用 jenv 管理多个 java 版本,但是都遇到了同样的问题,终端下载的时候都需要从 github 克隆,即使开了系统代理,但是终端始终无法访问到 github 导致下载失败。

## 验证代理是否生效
curl -I https://github.com  # 一直不动,无法响应 HTTP 200

原因

当系统代理已设置但终端无法访问 GitHub 时,通常是因为终端应用(如 gitcurlbrew 等)未自动继承系统代理设置。

image

解决方案

以下是逐步排查和解决方案:

1. 确认终端是否配置了代理环境变量

大多数命令行工具需要手动设置代理变量才能通过代理访问网络。
打开终端,检查以下变量是否已配置:

echo $HTTPS_PROXY   # 检查 HTTPS 代理变量

若未设置,手动添加代理配置(根据你的代理地址和端口修改):

  # 临时生效(仅当前终端窗口)
  export HTTPS_PROXY="http://127.0.0.1:7890"

  # 永久生效(添加到 Shell 配置文件 - 按需设置)
  echo 'export HTTPS_PROXY="http://127.0.0.1:7890"' >> ~/.zshrc
  source ~/.zshrc

2. 验证代理是否生效

使用 curl 测试是否通过代理访问 GitHub:

curl -I https://github.com

若返回超时或连接失败
• 检查代理地址和端口是否正确(如 Clash 默认端口是 7890)。
• 确认代理客户端是否在运行(重启代理工具)。

总结:终端代理配置要点

  1. 临时设置 HTTPS_PROXY 环境变量。
  2. 通过 curl 验证代理是否生效

完成后,测试终端访问:

# 临时生效(仅当前终端窗口)
export HTTPS_PROXY="http://127.0.0.1:7890"

# 验证代理是否生效
curl -I https://github.com  # 秒响应,返回 HTTP 200

# 删除环境变量(仅当前终端窗口)
unset HTTPS_PROXY
posted @ 2025-03-31 15:32  苏杰豪  阅读(1022)  评论(1)    收藏  举报