macOS 环境安装

本页仅针对 macOS。其他系统请见 Linux 环境安装、Windows 环境安装，或返回 环境安装总览。

推荐顺序

在新 Mac 上建议按下面顺序做，少踩「缺编译器 / 缺 git」之类的坑：

1. 先装 Xcode Command Line Tools：终端执行 xcode-select --install，按弹窗完成安装（详见下文「1. 安装 Xcode 和开发工具」）。Homebrew、从源码编译的包、以及许多安装脚本都依赖其中的 git、clang、make 等。
2. 再装 Homebrew（详见「2. 安装 Homebrew」），之后可用 brew install 装大量命令行工具和图形应用。
3. 再按需安装 Node.js、Oh My Zsh、字体、编辑器等（本文后续章节）；Node 见「3. 安装 Node.js 和包管理器」，也可用 brew install node 等方式安装。

若你直接跑 Homebrew 安装脚本，有时也会提示安装 Command Line Tools，但先装好 CLT 再装 Homebrew，流程通常更顺、更少中断。

📋 安装清单

• Xcode Command Line Tools（或完整 Xcode）
• Homebrew
• Node.js 和包管理器（nvm 等）
• Oh My Zsh
• Zimfw 和 Powerlevel10k
• Nerd 字体
• Vim 配置

1. 安装 Xcode 和开发工具

做一般开发时，安装 Xcode Command Line Tools（命令行工具）即可，其中包含 git、clang、make 等，不必仅为使用 Git 而安装完整 Xcode。

• 仅命令行工具（推荐大多数场景）：在终端执行 xcode-select --install，按弹窗提示安装。若尚未安装过，首次在终端运行 git 时系统也可能提示安装「命令行开发者工具」。
• 完整 Xcode（仅当你需要 Xcode IDE / iOS 等开发）：从 App Store 安装 Xcode；安装后同样具备上述命令行工具，通常无需再单独安装 Command Line Tools。

2. 安装 Homebrew

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

3. 安装 Node.js 和包管理器

安装 Node.js

访问 Node.js 官网 下载并安装最新的 LTS 版本。

安装 nvm (Node Version Manager)

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

安装 nrm (Node Registry Manager)

npm install -g nrm

4. 安装 Oh My Zsh

sh -c "$(curl -fsSL https://gitee.com/mirrors/oh-my-zsh/raw/master/tools/install.sh)"

5. 安装 Zimfw

curl -fsSL https://raw.githubusercontent.com/zimfw/install/master/install.zsh | zsh

6. 安装 Powerlevel10k 主题

方法一：直接安装

git clone --depth=1 https://gitee.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

方法二：通过 Zimfw 安装

在 ~/.zimrc 文件中添加：

zmodule romkatv/powerlevel10k

然后执行：

zimfw install

7. 安装 Nerd 字体

推荐字体

• Hack Nerd Font (搜索 Hack)
• MesloLGS NF
• JetBrains Mono

终端字体配置

在终端设置中配置字体为 Nerd 字体，确保图标正常显示。

8. 配置 Vim

安装 vim-web 配置

curl -sLf https://gitee.com/jaywcjlove/vim-web/raw/master/install | bash -s -- install

必备插件

vim-web 已经预置了以下插件：

• NERDTree (工程文件菜单)
• Emmet.vim (HTML/CSS 自动补全)
• Tagbar (代码导航)
• vim-easymotion (文本搜索)
• ctrlsf.vim (文件搜索)
• VimGitGutter (Git 集成)
• vim-multiple-cursors (多光标编辑)
• vim-signature (书签可视化)
• indexer (自动生成标签)

推荐主题

• vim-colors-solarized
• molokai

9. 配置 Zsh

在 ~/.zshrc 末尾添加

echo '(( ! ${+functions[p10k]} )) || p10k finalize' >>! ~/.zshrc

PATH 配置

在 ~/.zshrc 中添加：

export PATH=$HOME/bin:$HOME/.local/bin:/usr/local/bin:$PATH

✅ 验证安装

完成以上步骤后，重启终端并验证：

# 检查 Homebrew
brew --version

# 检查 Node.js
node --version
npm --version

# 检查 Oh My Zsh
echo $ZSH_VERSION

# 检查 Zimfw
zimfw --version

🎉 下一步

环境安装完成后，继续安装 开发工具 吧！

---

遇到问题？ 查看 问题排查 页面。