GUI软件内置终端PATH异常的根本原因是其不加载~/.zshrc；macOS GUI程序由launchd启动，仅读取~/.zprofile，需将PATH配置移至此并source ~/.zshrc，或为WezTerm等硬编码PATH，或用launchd全局注入。
gui 软件（如 vs code、pycharm、wezterm、clion）启动后，内置终端常出现 command not found 或命令版本异常，根本原因不是软件没装好，而是它压根没加载你终端里生效的 path —— 它们不走 shell 配置文件那一套。
为什么 GUI 应用看不到 ~/.zshrc 里的 PATH？
macOS 的 GUI 程序由 launchd 启动，不经过 Terminal 那种交互式 shell 流程。即使你反复 source ~/.zshrc，对 Dock 点开的 VS Code 也完全无效。它默认只读系统级环境变量，不会自动执行你的 shell 初始化脚本。
验证方法很直接：
- 在 Terminal 中运行
echo $PATH，记下输出 - 打开 VS Code → 新建内置终端 → 运行同样命令
- 两处输出不一致，就坐实了这个问题
统一 PATH 加载：让 ~/.zprofile 承担登录 Shell 责任
macOS 登录 shell（GUI 应用继承的环境来源）默认读取 ~/.zprofile，而非 ~/.zshrc。最稳妥的做法是把 PATH 设置逻辑集中到 ~/.zprofile，并让它主动加载 ~/.zshrc（如果里面还有别的重要配置）：
- 编辑
~/.zprofile：nano ~/.zprofile - 添加这行（确保放在最前面或 PATH 相关语句之前）：
source ~/.zshrc - 保存退出后，运行
source ~/.zprofile生效 - 重启所有 GUI 应用（必须完全退出再重开，不能只是窗口关闭）
针对 WezTerm 等特殊终端：在配置中硬编码 PATH
WezTerm 的 Lua 配置环境与用户 shell 完全隔离，os.getenv("PATH") 可能为空。不能依赖外部加载，得显式拼接：
- 打开 WezTerm 配置文件（通常是
~/.wezterm.lua） - 在
return { ... }块内加入：set_environment_variables = { PATH = "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:" .. (os.getenv("PATH") or "") } - 注意路径顺序：把 Homebrew、自定义工具路径放前面，避免被系统路径覆盖
- 保存后重启 WezTerm，新会话即生效
终极兜底：用 launchd 全局注入 PATH
如果上述方法仍不稳定（尤其多用户或企业环境），可让 macOS 系统级服务统一提供 PATH：
- 创建文件：
~/Library/LaunchAgents/environment.plist - 内容需为标准 XML，声明 PATH 值（不能含变量，必须写死完整路径，例如
/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin） - 运行：
launchctl load ~/Library/LaunchAgents/environment.plist - 完全退出并重启所有 GUI 应用
该方式绕过 shell 层，对所有从 Dock/Spotlight 启动的程序生效，适合长期稳定使用。
