macOS 系统下各种开发环境的路径与配置清单-Mac OS-PHP中文网

macos开发环境路径分三层：系统级路径固定（如xcode在/applications/xcode.app、clt在/library/developer/commandlinetools），用户级配置由shell文件驱动（zsh下优先用~/.zprofile设path，~/.zshrc设别名），语言环境依赖各自管理器（homebrew按芯片架构分装/opt/homebrew或/usr/local，java用/usr/libexec/java_home动态获取jdk路径）。

macos 下开发环境的路径和配置不是“一套通用模板”，而是按工具链分层管理：系统级路径固定，用户级配置靠 shell 文件驱动，语言/框架环境则依赖各自管理器。关键在于理清层级关系，避免硬编码路径或混淆 shell 配置文件。

Xcode 与命令行工具路径

Xcode 安装后主程序默认在：
/Applications/Xcode.app
其配套的命令行工具（clang、git、make 等）实际安装在：
/Library/Developer/CommandLineTools
若同时装了 Xcode 和 Command Line Tools，需手动指定路径，否则 xcode-select -p 可能指向错误位置。常用修复命令：

查看当前选中的路径：xcode-select -p
切换为 Xcode 内置工具：sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
切换为独立命令行工具：sudo xcode-select -s /Library/Developer/CommandLineTools

Homebrew 安装路径与配置

Apple Silicon（M 系列芯片）Mac 默认安装到：
/opt/homebrew
Intel 芯片 Mac 默认安装到：
/usr/local
安装后必须将对应路径加入 $PATH，否则 brew 命令不可用。配置方式取决于你使用的 shell：

Zsh（macOS 10.15+ 默认）：向 ~/.zshrc 或 ~/.zprofile 添加
eval "$(/opt/homebrew/bin/brew shellenv)"（M 系列）
或 export PATH="/usr/local/bin:$PATH"（Intel）
生效配置：source ~/.zshrc（或 source ~/.zprofile）

Java 环境路径与变量设置

JDK 安装后统一存放在：
/Library/Java/JavaVirtualMachines/
每个版本是一个子目录，例如：
/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home
不建议硬写具体版本路径，推荐用系统命令动态获取：

获取当前默认 JDK 路径：/usr/libexec/java_home
获取指定版本路径：/usr/libexec/java_home -v 17
在 ~/.zshrc 中设为环境变量：
export JAVA_HOME=$(/usr/libexec/java_home)
或多版本切换时定义别名：
alias jdk17='export JAVA_HOME=$(/usr/libexec/java_home -v 17)'

Python 与 Node.js 的典型路径

通过 Homebrew 安装的 Python 和 Node.js 二进制文件路径一致：
/opt/homebrew/bin/python3（M 系列）
/usr/local/bin/python3（Intel）
但它们的包安装位置不同：

Python pip 包默认安装到：
$(python3 -m site --user-site)（用户级）
或 /opt/homebrew/lib/python3.x/site-packages（全局，Homebrew 管理）
Node.js 全局模块路径：
npm config get prefix → 通常是 /opt/homebrew/lib/node_modules
全局 bin 目录：/opt/homebrew/bin（已含在 $PATH 中）