macOS多用户共享环境变量应统一配置于系统级文件：/etc/profile用于JAVA_HOME等非PATH变量，/etc/paths.d/用于模块化PATH管理，GUI应用需通过LaunchAgents/Daemons注入环境，避免修改PATH或敏感信息明文存储。
macos 上实现多用户共享环境变量，关键不是让每个用户各自复制一份配置，而是把变量定义在所有用户都能读取、且 shell 启动时自动加载的系统级位置。这种方式避免重复维护，也确保 cli 工具、脚本、ci 本地模拟等场景行为一致。
用 /etc/profile 统一声明非 PATH 类变量
这是最直接、跨 shell（bash/zsh）通用的方式。所有登录终端都会加载它：
- 用 sudo nano /etc/profile 编辑，添加类似内容：
export JAVA_HOME=$(/usr/libexec/java_home -v 17) export ANDROID_HOME="/opt/android-sdk" export EDITOR="code --wait"
- 保存后，新打开的终端即生效；无需 source，也不依赖用户 shell 类型
- 适合设置 JAVA_HOME、ANDROID_HOME、EDITOR、LANG 等不随用户变化的全局变量
- ⚠️ 不要在这里修改 PATH —— 它会被后续的 path_helper 覆盖或打乱优先级
用 /etc/paths.d 实现 PATH 的模块化共享
Apple 官方推荐的 PATH 管理机制，所有用户、所有 shell（包括 GUI 应用通过 launchd 启动时）都受其影响：
- 创建文件：sudo nano /etc/paths.d/mytools
- 只写一行路径，例如：
/opt/local/bin
/usr/local/go/bin - 每行一个绝对路径，不能含空格、变量、export 或 $PATH
- 系统启动时由 path_helper 自动合并到 PATH 开头
- 多个工具可各自建文件（如 brew、flutter、android），互不干扰
为 GUI 应用补全环境变量继承
图形界面程序（VS Code、PyCharm、Terminal.app 内置终端）不读 ~/.zshrc，而是从 launchd 继承环境。需显式注入：
- 创建 ~/Library/LaunchAgents/environment.plist（当前用户）或 /Library/LaunchDaemons/environment.plist（全系统）
- 在 plist 中用 <key>PATH</key> 和 <string>...</string> 显式声明完整 PATH 值（可调用 /usr/bin/getconf PATH 获取基础值再拼接）
- 运行 launchctl load ~/Library/LaunchAgents/environment.plist 激活
- 重启 GUI 应用才能生效
避免常见陷阱
多用户共享不等于“随便改”：
- 不要修改 /etc/bashrc 或 /etc/zshrc —— 它们不是标准加载路径，zsh 甚至默认不读 /etc/zshrc
- 不要在 /etc/profile 里写 export PATH=... —— 会覆盖 path_helper 的结果，导致 brew、Xcode 工具链失效
- 用户级配置（~/.zshrc）中应只做个性化覆盖，比如 export PATH="/my/local/bin:$PATH"，不干扰共享部分
- 敏感变量（如 API_KEY）不应放在系统级文件中，应由项目级 .env 或密钥管理器处理
