必须最先安装command line tools、homebrew和git三者,缺一不可:执行xcode-select --install安装命令行工具并验证clang/make版本;用官方脚本安装homebrew后运行brew doctor检查环境;再通过brew install git安装并配置user.name与user.email。
macos 下配开发框架和工具,关键不是堆砌数量,而是让每一步都稳得住——命令行能跑、环境变量不打架、权限不出错,这三件事理顺了,后续扩展才不会反复踩坑。
先打好底层基础
这三样必须最先装好,缺一不可,后续几乎所有工具都依赖它们:
-
Command Line Tools:不是 Xcode 的替代品,而是轻量级编译调试底座。终端执行
xcode-select --install,弹窗确认即可。装完验证:clang --version和make --version应正常输出。 -
Homebrew:macOS 的事实标准包管理器。用官方脚本安装:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
装完运行brew doctor检查 PATH 是否正确、是否需修复权限等关键项。 -
Git:现代开发绕不开的版本控制。Homebrew 安装最稳妥:
brew install git。装完立刻配置身份:git config --global user.name "Your Name"和git config --global user.email "you@example.com"。
按需选装主流运行时
别贪多,优先装稳定 LTS 版本,避免 beta 或过旧版本:
-
Python:推荐用 Homebrew 安装原生 Python(
brew install python),它自带 pip 和 venv,适合日常脚本与轻量后端。如需科学计算或数据工程,再额外装 Miniforge,不建议混用多个 Python 管理器。 -
Node.js:前端、CLI 工具、自动化脚本常用。
brew install node即可。注意 npm 全局模块默认装在~/Library/npm,记得把对应 bin 目录加入 PATH(例如加到~/.zshrc中)。 -
Java(JDK):若需 Java 开发,推荐通过 Homebrew 安装 Temurin(Eclipse 基金会维护的 OpenJDK):
brew tap homebrew/cask-versions && brew install --cask temurin17。装完检查java -version和$JAVA_HOME是否指向正确路径。
增强终端与编辑体验
命令行是开发主战场,提升效率靠的是“顺手”而非“花哨”:
-
iTerm2 + Oh My Zsh:系统 Terminal 功能够用,但 iTerm2 在分屏、搜索、粘贴行为上更贴近开发者习惯;Oh My Zsh 提供插件和主题支持,安装后可快速启用
git、zsh-autosuggestions等实用插件。 -
VS Code:主力编辑器首选。用
brew install --cask visual-studio-code安装。首次启动后,推荐装 ESLint(JS/TS)、Python(含 Pylance)、Docker、GitLens 这几类高频插件。 -
常用 CLI 工具补全:比如
htop(进程监控)、fzf(模糊搜索)、ripgrep(快速文本检索)、jq(JSON 解析),都可通过brew install一键获取。
安全与协作细节不能跳过
这些步骤常被忽略,但直接影响后续 SSH 登录、CI 集成、远程协作:
-
SSH 密钥生成与托管:用
ssh-keygen -t ed25519 -C "your_email@example.com"创建密钥,再用ssh-add ~/.ssh/id_ed25519加载,并把公钥添加到 GitHub/GitLab 等平台。 -
Starship 提示符:比默认 Zsh 提示更直观,显示当前目录、Git 分支、Python 虚拟环境等状态,安装简单:
brew install starship,并在~/.zshrc中添加eval "$(starship init zsh)"。 -
tmux 配置(可选但推荐):适合需要长期保持会话的场景(如服务器调试、日志跟踪)。基础安装
brew install tmux,再配合.tmux.conf自定义快捷键和面板布局。











