核心在于gui应用无法继承终端配置的环境变量，必须通过envpane或修改~/.zprofile并执行launchctl setenv注入launchd会话，使vs code、emacs等新启动应用立即继承path等变量。
macos 开发环境中的环境变量注入问题，核心在于应用程序（如 emacs、vs code、gui 工具）无法继承你在终端里配置的 path 和其他变量。这不是配置没写，而是 macos 的沙盒机制和 launchd 会话隔离导致 gui 应用启动时“看不见”你的 shell 环境。修复关键在于让变量真正进入用户的 launchd 会话，并被所有后续进程继承。
确认问题根源：GUI 应用 vs 终端应用
在终端中运行 echo $PATH 正常，但打开 VS Code 或 Emacs 后执行 M-x shell 却报 command not found，说明变量只对当前 shell 有效，未注入到图形界面的父进程（launchd）。macOS 不会自动把 ~/.zshrc 里的 export 传递给 Dock 启动的应用。
- 终端应用（iTerm、Terminal）读取 ~/.zshrc 或 ~/.zprofile，所以命令可用
- GUI 应用由 launchd 拉起，只继承其 session 的环境变量，而默认 session 环境极简（通常只有 /usr/bin:/bin:/usr/sbin:/sbin）
- Homebrew 安装的工具（如
/opt/homebrew/bin/git）不在默认路径中，自然找不到
优先使用 EnvPane 实现一键注入
EnvPane 是专为 macOS 设计的图形化环境变量管理工具，它绕过手动编辑的复杂性，直接向用户的 launchd 实例写入变量，新启动的 GUI 应用立即生效。
- 安装后打开「系统设置 → 隐私与安全性 → 完全磁盘访问」，勾选 EnvPane（首次需授权）
- 在 EnvPane 界面中添加 PATH 变量，值设为：
/opt/homebrew/bin:/usr/local/bin:$PATH（Apple Silicon 用前者，Intel 用后者） - 点击「Apply」，无需重启，新开 VS Code 或 Emacs 就能识别 brew 命令
- 它还会自动处理变量插值（比如
$HOME），并校验语法，避免手误导致 PATH 被覆盖
手动注入：修改 ~/.zprofile 并加载到 launchd
如果你倾向命令行方式，必须确保变量从登录会话源头注入，而不是只写在 ~/.zshrc（它只影响子 shell，不影响 GUI 进程）。
- 编辑
~/.zprofile（不是 .zshrc），加入标准 PATH 补充：export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH" - 运行
launchctl setenv PATH "$PATH"，将当前 shell 的 PATH 注入当前 launchd session - 验证是否生效：
launchctl getenv PATH应返回含 brew 路径的字符串 - 重启 Dock 让变更全局生效：
killall Dock（桌面图标会闪一下，之后新启动的 GUI 应用就继承了）
针对 Emacs Plus 的专项修复
Emacs Plus 提供了内置 PATH 注入机制，但有时因升级或路径变更失效。不要依赖它自动识别，主动触发更可靠。
- 确认已安装对应版本（如 emacs-plus@31）：
brew info emacs-plus@31 - 手动重跑注入脚本：
brew postinstall emacs-plus@31 - 启动 Emacs 后，
M-x shell中执行echo $PATH，检查是否含/opt/homebrew/bin - 若仍缺失，可临时在 Emacs 配置中硬编码（仅作兜底）：
(setenv "PATH" (concat "/opt/homebrew/bin:" (getenv "PATH")))
