这篇教程面向两类人：一是新 Mac 开机后想快速把常用开发环境配齐；二是系统重装/换新机后，想把环境“装得快、管得住、可回滚”。下面用 Homebrew 做包管理，再分别把 Node、Python、Git 配到一个可维护的状态。
建议先确认两点：
1) macOS 版本较新（10.15+ 更省心）；2) 有稳定网络；3) 能打开终端（Terminal/iTerm2 都可以）。
如果你在公司网络环境下，尽量先确认代理/网络策略是否允许访问 GitHub 相关资源（Homebrew 的部分组件会依赖）。
Homebrew 是 macOS 上最常用的包管理器之一。安装完成后，你可以用一条命令安装/升级/卸载大量工具。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装结束后，按终端提示把 brew 加入 PATH。不同芯片路径不同：
# Apple Silicon (M1/M2/M3) # 通常会提示你执行： # echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile # eval "$(/opt/homebrew/bin/brew shellenv)" # Intel # 一般是 /usr/local/bin/brew验证：
brew --version建议先把通用工具装上，后续排查会更轻松：
brew install git wget curl jq tree coreutils可选（按需）：
# 更好用的终端体验 brew install zsh-autosuggestions zsh-syntax-highlighting # 你常用的编辑器/终端（GUI） brew install --cask iterm2 visual-studio-code很多项目会要求不同的 Node 版本。与其只装一个 Node，不如用版本管理器（例如 fnm 或 nvm）。这里给一个偏省事的方案：fnm（Rust 实现，速度快）。
brew install fnm然后把初始化写入你的 shell 配置（zsh 常见是 ~/.zshrc）。
# 在 ~/.zshrc 里添加（示例） eval "$(fnm env --use-on-cd)"安装并切换 Node：
fnm install --lts fnm use --lts node -v npm -v建议把常用全局工具也统一管理，例如：
npm i -g pnpm@latest提示：如果你遇到“权限不足”一类问题，不要用 sudo 强行装全局包，优先检查 Node 是否由 fnm 管理、以及 npm 的全局目录是否落在你的用户目录。
Python 也经常遇到“项目 A 要 3.10，项目 B 要 3.12”的情况。pyenv 的思路是把不同 Python 安装到独立目录，然后用项目级别的版本选择来隔离。
brew install pyenv初始化（zsh 示例，写入 ~/.zshrc）：
export PYENV_ROOT="$HOME/.pyenv" export PATH="$PYENV_ROOT/bin:$PATH" eval "$(pyenv init -)"安装与切换：
pyenv install 3.12.2 pyenv global 3.12.2 python3 --version项目级别建议用虚拟环境（venv/poetry 皆可）。一个最通用的方式：
python3 -m venv .venv source .venv/bin/activate pip install -U pipGit 安装后，至少做两件事：设置用户名邮箱、设置默认分支名（可选）。
git config --global user.name "Your Name" git config --global user.email "you@example.com"如果你经常写提交信息，建议配一个更清晰的日志与别名：
git config --global alias.lg "log --oneline --decorate --graph --all"SSH/HTTPS 任选其一即可。团队协作时，优先按公司规范走。
Homebrew 的维护节奏建议是“定期升级、遇到问题再锁版本”。常用命令：
# 更新索引并升级 brew update brew upgrade # 清理旧版本与缓存（节省空间） brew cleanup如果升级后出现兼容问题，优先查看具体报错对应的工具版本，再决定是否回退/切换项目版本管理器（例如 Node 用 fnm 切换，Python 用 pyenv 切换）。
Q1：brew 命令找不到？
多半是 PATH 没配置。按安装结束的提示把 shellenv 写入 ~/.zprofile 或 ~/.zshrc，然后重新打开终端。
Q2：安装某些包失败，提示缺少 Xcode/Command Line Tools？
先安装命令行工具，再重试：
xcode-select --installQ3：Node/Python 版本混乱？
优先确认你是否在用版本管理器：Node 看 fnm/nvm，Python 看 pyenv；不要把系统自带版本当成项目依赖版本使用。
环境配置最怕“一次装好就不管”。用 Homebrew + 版本管理器的组合，你可以把升级、切换、排查流程标准化。下次换新机时，只要按同样步骤跑一遍，就能快速恢复工作流。
