macos系统服务默认不继承shell环境变量，需通过launchctl setenv或launchagent plist显式注入；/etc/paths.d方式更安全避免path覆盖；验证须查进程实际环境而非终端变量。

macos 系统服务（如 launchd 管理的守护进程、launchagents、后台代理）默认不继承用户 shell 的环境变量，它们由 launchd 启动，环境变量需通过 launchd 机制显式注入，而非写进 ~/.zshrc 或 /etc/profile —— 后者只影响终端会话及其子进程。

用 launchctl setenv 注入系统服务可见的变量

该命令专为 launchd 设计，设置的变量对后续由系统启动的服务（包括 GUI 应用、LaunchAgents、定时任务等）生效，但不影响当前终端会话：

• launchctl setenv JAVA_HOME "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"
• launchctl setenv EDITOR "code --wait"
• launchctl setenv PATH "/opt/homebrew/bin:/usr/local/bin:$PATH"

⚠️ 注意：执行后需注销再登录（或重启），新启动的服务才能读取；已运行的服务不会自动更新。

通过 LaunchAgent plist 文件持久化注入

比临时 launchctl 更可靠，适合长期部署。在 ~/Library/LaunchAgents/ 下创建 plist（如 com.user.env.plist）：

内容示例：

macOS Notes

通过 AppleScript 创建、读取、搜索及管理 macOS 备忘录。适用于用户要求记笔记、记录事项、保存想法、创建会议记录等场景。

下载

  
    Label
    com.user.env
    ProgramArguments
    
      zsh
      -c
      launchctl setenv GOPATH /Users/you/go; launchctl setenv GOROOT /opt/homebrew/opt/go/libexec
    
    RunAtLoad
    
  

保存后加载：
launchctl load ~/Library/LaunchAgents/com.user.env.plist
launchctl start com.user.env

避免 PATH 覆盖，优先用 /etc/paths.d

系统服务的 PATH 默认由 path_helper 生成，直接用 launchctl setenv PATH 容易覆盖原始路径，引发命令找不到问题。推荐方式：

• 新建文件：

  sudo tee /etc/paths.d/mytools /opt/myapp/bin<br>EOF

• 无需重启，所有新启动的系统服务（含 GUI）都会自动包含该路径

验证服务实际使用的环境

不能只靠 echo $VAR 在终端测 —— 那是 shell 环境。要查服务真实环境：

• 找目标进程 PID：ps aux | grep "YourApp"
• 查看其完整环境：sudo cat /proc/[PID]/environ | tr '\0' '\n' | grep -i "var_name"（macOS 不支持 /proc，改用）
• 更实用方法：在 LaunchAgent 的 ProgramArguments 中加一条调试命令，例如：env > /tmp/service-env.txt，再启动服务查看输出