你可能刚拿到一台新 Mac，或者系统重装后准备重新搭环境：希望安装方式尽量「标准、可维护、可迁移」，不要走偏门，也不想把系统弄乱。本教程用 Homebrew 作为核心包管理器，搭一套日常开发/效率常用软件的“可复制清单”。
Homebrew 在 Intel 与 Apple Silicon（M 系列）上路径和默认安装位置不同，这会影响到环境变量与终端配置。你可以在“关于本机”里查看芯片类型。
建议先做两件事：1）系统更新到较新稳定版本；2）确保你有可用的网络（能访问 GitHub 或 Homebrew 源站）。如果网络不稳定，后文会给出加速与排查思路。
Homebrew 依赖一些编译与基础工具，通常需要先安装命令行工具。打开“终端（Terminal）”执行：
xcode-select --install弹窗出现后选择安装即可。安装完成后，你可以执行下面命令确认路径已就绪：
xcode-select -p建议优先使用 Homebrew 官方提供的安装脚本。执行：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装过程中会提示你输入管理员密码，并可能询问是否继续（按提示确认即可）。
macOS 默认 shell 多为 zsh。Homebrew 安装结束后会给出提示，让你把 brew 加入 PATH。常见情况：
Apple Silicon（M 系列）默认在 /opt/homebrew；Intel默认在 /usr/local。
以 Apple Silicon 为例，把下面这行写入 ~/.zprofile（按安装提示为准）：
eval "$(/opt/homebrew/bin/brew shellenv)"然后重新打开终端，或执行一次：
source ~/.zprofile验证是否安装成功：
brew -v brew doctorbrew doctor 如果给出建议，按它提示逐条修复即可（比如权限、PATH 顺序等）。
Homebrew 默认会在安装/升级时自动更新索引；在网络不稳定时，可能会导致等待较久。你可以根据自己的习惯选择策略：
# 查看环境与配置 brew config # 更新索引（手动） brew update # 升级已安装的软件 brew upgrade # 清理旧版本缓存 brew cleanup建议保留“手动 update + 定期 upgrade”的习惯，能减少不必要的等待，也便于排查问题。
如果你在国内网络环境下遇到下载慢或超时，优先思路是：1）更换稳定网络；2）在公司/家庭环境使用合规的网络加速方案；3）选择镜像源（如果你所在网络/单位允许）。
排查建议：
# 确认能访问 GitHub ping -c 3 github.com # 观察 brew 拉取卡在哪一步 brew update -v如果卡在某个域名解析/连接，通常是网络问题；如果是权限或 PATH 问题，brew doctor 会给出更明确的方向。
下面给一个偏通用的清单，你不需要全装，按自己的工作类型选择即可。
基础开发工具
brew install git brew install wget brew install ripgrep brew install jq brew install tree运行时与版本管理（按需）
# Node.js（如果你需要前端/脚本） brew install node # Python（macOS 自带 Python 可能不满足需求） brew install python # Java（如需要） brew install --cask temurin终端与效率工具（cask 安装 GUI 应用）
brew install --cask iterm2 brew install --cask visual-studio-code brew install --cask google-chrome brew install --cask raycast说明：--cask 用于安装图形化应用。安装完成后，可在“应用程序”中看到对应软件。
搭完环境后，建议把常用软件清单记录下来（例如写成一份列表），下次换机或重装时直接照单执行，避免遗漏。Homebrew 也提供了导出思路（例如记录已安装包列表），让你能更快复原。
1）brew: command not found：多半是 PATH 没生效。回到“配置环境变量”一节，按 Homebrew 安装提示把 shellenv 加入启动文件，并重新打开终端。
2）权限相关报错：不要粗暴给目录全局提权。优先用 brew doctor 的建议定位具体路径，按提示修复目录权限。
3）下载太慢或超时：优先换网络或在合规前提下使用加速；必要时分步骤执行（先 brew update，再逐个安装），更容易定位是哪一步失败。
环境搭好后，建议每 1-2 周做一次维护：brew update + brew upgrade + brew cleanup。这会让你的工具链保持健康，也更不容易在关键时刻遇到“版本太旧导致不兼容”。
