macOS 开发环境基石是 Command Line Tools、Homebrew 和 Git，需依次安装并验证：运行 xcode-select --install 安装命令行工具，用 clang --version 和 make --version 验证；通过官方脚本安装 Homebrew 后执行 brew doctor 检查；再 brew install git 并配置全局用户信息；Apple Silicon 与 Intel 芯片需分别在 ~/.zshrc 中添加对应 eval "$(/opt/homebrew/bin/brew shellenv)" 或 eval "$(/usr/local/bin/brew shellenv)"，source 后用 which brew 确认路径；日常需定期 brew update && brew upgrade && brew cleanup，并统一管理 Python/Node.js/Java 等运行时，避免多管理器混用。
macos 上安装和管理基础开发库，核心不是“装多少”，而是让底层链路跑得稳——命令行工具能调用、包管理器不报错、环境变量指向清晰。三件事理顺了，后续加 python、node 或 java 才不会反复出问题。
先装好三大基石
Command Line Tools、Homebrew、Git 必须优先安装，它们是绝大多数开发库的依赖底座：
- 运行 xcode-select --install 安装命令行工具，弹窗确认后等待完成；验证方式：执行 clang --version 和 make --version 应有正常输出
- 用官方脚本安装 Homebrew：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"；装完立刻运行 brew doctor 检查 PATH 和权限问题
- 通过 Homebrew 安装 Git：brew install git；装完马上配置身份：git config --global user.name "Your Name" 和 git config --global user.email "you@example.com"
Homebrew 环境要设对路径
Apple Silicon（M系列）芯片的默认安装路径是 /opt/homebrew，Intel 芯片是 /usr/local。路径没设对，brew 命令会找不到或报错：
- 在 ~/.zshrc 末尾添加：eval "$(/opt/homebrew/bin/brew shellenv)"（M系列）或 eval "$(/usr/local/bin/brew shellenv)"（Intel）
- 执行 source ~/.zshrc 生效；之后 which brew 应返回对应路径下的可执行文件
- 日常维护建议每周运行一次：brew update && brew upgrade && brew cleanup
按需装主流运行时，别混多个管理器
选稳定 LTS 版本，避免 beta 或老旧版本，同一语言尽量只用一种安装方式：
- Python：直接 brew install python，自带 pip 和 venv，够用；科学计算需求再额外装 Miniforge，不建议同时用 pyenv + brew 管理
- Node.js：brew install node；npm 全局模块默认装在 ~/Library/npm，需把 ~/Library/npm/bin 加进 PATH
- Java（JDK）：推荐 brew tap homebrew/cask-versions && brew install --cask temurin17；装完检查 java -version，并确认 $JAVA_HOME 指向 /opt/homebrew/opt/temurin17/libexec/openjdk.jdk/Contents/Home（M系列）
验证与日常维护要点
每次装新库前，花一分钟确认基础是否健康，能省去大量排查时间：
- 运行 brew doctor —— 它会提示 PATH 冲突、权限异常、旧版本残留等关键问题
- 检查 which clang、which git、which python3 是否都来自预期路径（如 /opt/homebrew/bin 或 /usr/bin）
- 若遇到 “command not found” 或版本错乱，优先查 echo $PATH 和 type -a xxx，而不是直接重装
