如何设置MacOS终端环境变量Proxy并实现持久化生效-Mac OS-PHP中文网

export http_proxy只在当前终端生效，因其仅设置当前shell进程的环境变量；关闭终端或新建窗口后需将export语句写入对应shell配置文件（如zsh用户为~/.zshrc）并source或重启终端才持久生效。

如何设置macos终端环境变量proxy并实现持久化生效

为什么 export HTTP_PROXY 只在当前终端生效

因为 export 设置的是当前 shell 进程的环境变量，关闭终端或新开一个 tab 就会丢失。MacOS 的终端（如 Terminal.app 或 iTerm2）默认启动的是登录 shell，但每次新建窗口并不会自动重新执行你写在配置文件里的命令——除非你把变量声明放在正确的初始化文件里，并确保 shell 正确加载它。

常见误区是只改了 ~/.bash_profile 却用 zsh（macOS Catalina+ 默认），结果完全不生效；或者加了 export 却漏掉 export 关键字本身，导致变量只是 shell 变量而非环境变量。

检查当前 shell：echo $SHELL，确认是 /bin/zsh（Catalina 及以后）还是 /bin/bash
zsh 用户应编辑 ~/.zshrc（非 ~/.bash_profile）
必须写成 export HTTP_PROXY="http://127.0.0.1:8080"，不能只写 HTTP_PROXY="http://127.0.0.1:8080"
改完后需手动执行 source ~/.zshrc 或新开终端才生效

如何同时设置 HTTP_PROXY、HTTPS_PROXY 和 NO_PROXY

很多工具（curl、git、npm、pip）依赖这三者协同工作。漏掉 NO_PROXY 会导致内网请求也被转发到代理，引发超时或认证失败；HTTPS_PROXY 不设则部分 HTTPS 请求可能直连（绕过代理），尤其影响企业内网或私有仓库访问。

推荐写法（放入 ~/.zshrc）：

export HTTP_PROXY="http://127.0.0.1:8080"
export HTTPS_PROXY="http://127.0.0.1:8080"
export NO_PROXY="localhost,127.0.0.1,.example.com,192.168.0.0/16"

NO_PROXY 支持逗号分隔的域名、IP、CIDR（部分工具如 curl 8.5+ 支持，但 git 和 npm 仅支持域名/IP 和前缀点语法），注意 .example.com 表示匹配所有子域，而 example.com 只匹配精确域名。

避免在 NO_PROXY 中混用空格和逗号，如 "localhost, 127.0.0.1" 中的空格会导致某些工具解析失败
若代理需认证，格式为 http://user:pass@127.0.0.1:8080，但密码含特殊字符需 URL 编码
某些 CLI 工具（如 docker）不读取 HTTPS_PROXY，需单独配置其自身代理机制

为什么 VS Code 终端或 GUI 应用不继承这些变量

VS Code 默认通过 launchd 启动，不走 shell 初始化流程；GUI 应用（如 iTerm2 图标启动、Alfred Run）也往往跳过 ~/.zshrc。这不是配置错了，而是 macOS 的进程继承机制决定的。

解决方法是让 launchd 知道这些变量：

launchctl setenv HTTP_PROXY "http://127.0.0.1:8080"
launchctl setenv HTTPS_PROXY "http://127.0.0.1:8080"
launchctl setenv NO_PROXY "localhost,127.0.0.1,.example.com"

但 launchctl setenv 是临时的，重启后失效。要持久化，需创建 ~/Library/LaunchAgents/environment.plist 并加载：

<?xml version="1.0" encoding="UTF-8"?><plist version="1.0"><dict><key>Label</key><string>my.startup</string><key>ProgramArguments</key><array><string>sh</string><string>-c</string><string>launchctl setenv HTTP_PROXY "http://127.0.0.1:8080"; launchctl setenv HTTPS_PROXY "http://127.0.0.1:8080"; launchctl setenv NO_PROXY "localhost,127.0.0.1,.example.com"</string></array><key>RunAtLoad</key><true></true></dict></plist>

然后执行：launchctl load ~/Library/LaunchAgents/environment.plist

修改后需重启 VS Code 或其他 GUI 应用才能看到新变量
验证是否生效：launchctl getenv HTTP_PROXY
注意：此方式对 SIP 保护的系统进程无效，仅影响用户级 GUI 应用

代理配置被 Git / npm / curl 覆盖怎么办

这些工具允许在各自配置中硬编码代理，优先级高于环境变量。例如 git config --global http.proxy 设定后，即使环境变量清空，git 仍走代理；npm config get proxy 同理。

检查 git 代理：git config --get http.proxy，清除用 git config --unset http.proxy
检查 npm：npm config get proxy 和 npm config get https-proxy，清除用 npm config delete proxy
curl 默认读环境变量，但若命令行显式传了 --proxy 或配置了 ~/.curlrc，也会覆盖
建议统一用环境变量管理，禁用各工具的独立代理配置，避免冲突

真正麻烦的是那些不读环境变量的工具（比如旧版 docker CLI），它们需要各自单独配置，没法靠 shell 环境变量一劳永逸。