核心问题是配置文件未被当前shell加载：macOS Catalina起默认zsh，改.bash_profile无效；应确认shell类型（echo $SHELL），zsh用户配~/.zshrc并source生效，图形程序需通过launchd同步PATH。

配置后不生效，核心问题通常不是写错了，而是没被当前 shell 正确加载。macos 自 catalina（10.15）起默认用 zsh，但很多人仍习惯改 ~/.bash_profile，结果文件写了、保存了、也重启终端了——就是不生效。

确认你当前用的是哪个 shell

终端里直接运行：

echo $SHELL

如果输出是 /bin/zsh，那你改 ~/.bash_profile 就等于白改。zsh 默认不读这个文件。同理，如果是 /bin/bash，那 ~/.zshrc 也不会自动生效。

还可以补查一句：

ps -p $$

看输出的 CMD 列，能直观看到当前会话跑的是 zsh 还是 bash。

把变量写进对的配置文件

不同 shell 加载不同文件，且加载时机也有区别：

macOS Automator Services

部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...

下载

• zsh 用户（绝大多数新 Mac）：日常使用 ~/.zshrc（交互式终端每次启动都读）
• zsh 登录 shell（如远程 SSH）：会先读 ~/.zprofile，再读 ~/.zshrc
• bash 用户：用 ~/.bash_profile（登录 shell 时读一次）
• 想一劳永逸兼容两者：可把环境变量统一写进 ~/.profile，然后在 ~/.zshrc 和 ~/.bash_profile 里都加一行 source ~/.profile

改完必须手动重载，不能只靠重启终端

编辑保存后，当前终端不会自动更新。必须执行：

source ~/.zshrc（zsh 用户）
source ~/.bash_profile（bash 用户）

也可以设个快捷别名，比如在配置文件末尾加：

alias reload='source ~/.zshrc'

之后只要敲 reload 就行。

图形界面程序（VS Code、PyCharm 等）不认终端 PATH

它们不走 shell 启动流程，而是从系统级的 launchd 继承环境变量。所以即使终端里 echo $PATH 完全正确，VS Code 内置终端可能还是找不到命令。

解决方法是让 launchd 也加载你的 PATH：

• 创建文件：~/Library/LaunchAgents/environment.plist
• 内容需是标准 XML，声明 PATH 值（注意路径要完整、无错）
• 运行：launchctl load ~/Library/LaunchAgents/environment.plist
• 完全退出并重启 VS Code（不是只关终端面板）