先确认当前 shell 类型：执行 echo $shell，若为 /bin/zsh 则修改 ~/.zshrc 并 source 生效；若为 /bin/bash 则改 ~/.bash_profile；gui 应用需额外配置 launchd 或 ide 环境变量。
改完 PATH 不生效？大概率你编辑了错误的 shell 配置文件，或者没搞清当前终端用的是 zsh 还是 bash。
确认当前 shell 类型和配置文件位置
macOS Catalina（10.15）起默认 shell 是 zsh，不是 bash。改错文件等于白改。
执行以下命令确认：
echo $SHELL
如果输出是 /bin/zsh，就要改 ~/.zshrc（推荐）或 ~/.zprofile；如果是 /bin/bash，才去动 ~/.bash_profile。
常见误区：
- 在
~/.bash_profile里加 PATH，但系统用的是 zsh → 不生效 - 改了
~/.zshrc却没重新加载 → 新开终端才生效，当前终端仍用旧 PATH - 用 VS Code 内置终端，它可能不读
~/.zshrc（取决于启动方式）→ 需检查terminal.integrated.profiles.osx设置
在正确文件中追加 PATH 的标准写法
别直接写 PATH=xxx 覆盖原有值，否则会丢掉系统路径（比如 /usr/bin），导致 ls、python 等基础命令找不到。
应该用追加方式，例如把 /opt/homebrew/bin 加到最前（优先匹配）：
export PATH="/opt/homebrew/bin:$PATH"
如果要加多个路径，用冒号分隔，顺序很重要：
export PATH="/usr/local/bin:/opt/homebrew/bin:$PATH"
注意点：
- 路径中不能有空格（如有，必须用引号包裹，但 PATH 本身不支持带空格路径的可靠解析，建议避免）
- 不要用
~代替$HOME，某些 shell 启动场景下~不展开 - 确保路径真实存在，
ls -d /opt/homebrew/bin先验证
让修改立刻生效，而不是等重启终端
改完配置文件后，运行：
source ~/.zshrc
如果用了 ~/.zprofile，就运行：
source ~/.zprofile
验证是否生效：
echo $PATH
看输出里有没有你刚加的路径；再试：
which your-command
确认命令能被定位到新路径下。
容易漏的操作：
- 忘记
source，直接运行命令 → 用的还是旧 PATH - 在 iTerm2 里开了多个标签页，只 reload 了其中一个 → 其他标签页仍无效
- 用
sudo su切换用户后，PATH 是 root 的，跟你当前用户的配置无关
GUI 应用（如 VS Code、PyCharm）读不到终端 PATH 怎么办
图形界面应用不继承终端的 shell 环境，它们通常从 launchd 继承环境变量，而 launchd 默认不读 ~/.zshrc。
解决办法（macOS 12+ 推荐）：
创建或编辑 ~/Library/LaunchAgents/environment.plist，内容包含：
<key>EnvironmentVariables</key><dict><key>PATH</key><string>/opt/homebrew/bin:/usr/local/bin:$PATH</string></dict>
然后运行：
launchctl load ~/Library/LaunchAgents/environment.plist
再重启 GUI 应用。
更轻量的替代方案（VS Code 专用）：
在设置里搜 terminal.integrated.env.osx，添加：
"terminal.integrated.env.osx": {"PATH": "/opt/homebrew/bin:$PATH"}
但这只影响 VS Code 内置终端，不影响它启动的 GUI 子进程（如点击“运行”按钮调起的 Python 进程）。
真正麻烦的地方在于：PATH 修改看似简单，但生效范围高度依赖上下文——终端类型、GUI 启动方式、IDE 的子进程模型、甚至 Apple Silicon 和 Intel Mac 的 Homebrew 路径都不同。动手前先 echo $SHELL 和 ps -p $$ 确认环境，比硬套教程靠谱得多。
