新买 Mac？30 分钟从零到开发环境搭建完成

开始之前

这篇指南有两类读者：

刚换 Mac 的普通用户：看完前三节（系统设置 + 基础工具 + 国内优化）就够用了，后面的开发环境部分可以跳过。

从 Windows 迁移的开发者：全部看完，30 分钟内你会有一个完整可用的开发环境，包含 AI 工具支持。

左侧勾选框可以帮你记录进度，刷新页面也不会丢失。

系统设置

这是所有人都需要做的，把 Mac 调整到"顺手"状态。Windows 转过来最不习惯的几个地方，这里一次解决。

鼠标与触控板

打开「系统设置 → 触控板」：

• 轻点来点按：开启（不用按下去，轻触就是点击）
• 滚动方向：如果你不习惯 Mac 的"自然滚动"，可以在「鼠标」里关掉

打开「系统设置 → 辅助功能 → 指针控制 → 触控板选项」：

• 拖移样式：选"三指拖移"（拖窗口更自然）

Finder 设置

Finder 是 Mac 的文件管理器，默认设置对开发者不太友好：

打开 Finder，按 ⌘ + , 进入偏好设置：

• 通用：新窗口打开位置改为「下载」或「主目录」
• 高级：勾选「显示所有文件扩展名」

在 Finder 菜单栏点「显示 → 显示路径栏」和「显示状态栏」——这样你能看到当前在哪个目录，Windows 用户会更熟悉。

截图设置

Mac 自带截图功能比 Windows 的截图工具强很多：

截图默认保存在桌面，可以在 ⌘ + Shift + 5 里改保存位置。

终端里的系统优化（可选）

以下几行命令可以改善开发体验，复制粘贴到终端执行：

# 截图改为 JPG 格式（文件更小）
defaults write com.apple.screencapture type jpg

# Finder 显示隐藏文件（开发必备）
defaults write com.apple.finder AppleShowAllFiles YES

# 显示路径栏
defaults write com.apple.finder ShowPathbar -bool true

killall Finder

基础工具

这一节适合所有用户，都是免费工具，替代你可能付过钱的 Windows 软件。

Homebrew：Mac 的包管理器

这是 Mac 上最重要的工具，类似 Windows 上的 winget，但比它强得多。先装这个，后面所有工具都靠它。

打开终端（按 ⌘ + 空格 搜索"终端"），粘贴执行：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完验证：

brew --version
# 输出类似：Homebrew 4.x.x

Raycast：替代 Spotlight

⌘ + 空格 是 Mac 的搜索快捷键，默认打开 Spotlight。Raycast 是它的升级替代，免费版功能已经足够强大：

brew install --cask raycast

安装后打开 Raycast，把它的快捷键设置为 ⌘ + 空格（它会提示你禁用 Spotlight）。

Raycast 免费版包含：应用启动、文件搜索、剪贴板历史、窗口管理、计算器、单位换算。一个工具替代了四五个付费工具。

窗口管理：Rectangle（免费）

Windows 里拖窗口到边缘自动分屏，Mac 默认没有这功能。Rectangle 补上这个空缺：

brew install --cask rectangle

安装后支持快捷键分屏，⌃ + ⌥ + ← 左半屏，⌃ + ⌥ + → 右半屏，Windows 用户无缝适应。

视频播放：IINA（替代 VLC）

免费开源，原生 macOS 风格，支持几乎所有格式：

brew install --cask iina

解压工具：Keka（替代 WinRAR）

支持 zip、7z、rar 等，免费：

brew install --cask keka

密码管理：Bitwarden（免费开源）

别再用浏览器保存密码了，Bitwarden 开源、免费、可自托管：

brew install --cask bitwarden

卸载工具：AppCleaner

Mac 卸载 App 不像 Windows 有卸载程序，直接删除 App 会留下残余文件。AppCleaner 帮你彻底清除：

brew install --cask appcleaner

国内优化

这是你在其他 Mac 教程里几乎找不到的内容，也是国内用户最需要的部分。

Homebrew 镜像

默认 Homebrew 从 GitHub 下载，国内速度很慢。换成国内镜像：

# 中科大镜像（推荐）
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"

# 写入配置，永久生效
echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"' >> ~/.zshrc
echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"' >> ~/.zshrc
echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"' >> ~/.zshrc
source ~/.zshrc

npm 镜像

# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证
npm config get registry

Git 代理（可选）

如果你有代理工具，可以给 Git 单独配置：

# 替换成你的代理端口
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

# 取消代理
git config --global --unset http.proxy
git config --global --unset https.proxy

开发环境

从这里开始是开发者专属内容。普通用户可以到这里停下了。

Git 基础配置

Mac 自带 Git，但建议通过 Homebrew 安装最新版：

brew install git

# 配置用户信息（替换成你自己的）
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

# 默认分支名改为 main
git config --global init.defaultBranch main

# 验证
git --version

Node.js：用 fnm 管理版本

2026 推荐用 fnm（Fast Node Manager）替代 nvm，速度更快，对 Apple Silicon 支持更好：

brew install fnm

# 写入 zsh 配置
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc
source ~/.zshrc

# 安装 Node 22（当前 LTS）
fnm install 22
fnm use 22
fnm default 22

# 验证
node --version   # v22.x.x
npm --version

pnpm：2026 推荐的包管理器

不再推荐 npm 或 yarn 作为默认选择，pnpm 更快、节省磁盘空间：

npm install -g pnpm

# 验证
pnpm --version

编辑器：VS Code 或 Cursor

VS Code（稳定，生态最全）：

brew install --cask visual-studio-code

Cursor（VS Code 的 AI 强化版，2025-2026 爆发）：

brew install --cask cursor

两者可以共存。建议先装 VS Code，熟悉后再试 Cursor。

VS Code 推荐扩展（搜索名称安装）：

• ESLint — 代码检查
• Prettier — 代码格式化
• GitLens — Git 增强
• Tailwind CSS IntelliSense — Tailwind 提示
• Chinese (Simplified) — 中文界面（可选）

终端增强：iTerm2 + Starship

Mac 自带终端够用，但 iTerm2 体验更好：

brew install --cask iterm2

Starship 是一个跨 shell 的提示符美化工具，比 oh-my-zsh 更轻量：

brew install starship
echo 'eval "$(starship init zsh)"' >> ~/.zshrc
source ~/.zshrc

AI 工具

这是 2024-2026 最大的变化，也是其他 Mac 配置教程严重落后的地方。

Claude Desktop

本地运行的 Claude 客户端，支持文件分析、代码辅助：

brew install --cask claude

Claude Code：终端里的 AI 编程助手

这是 Anthropic 推出的命令行 AI 工具，可以直接在终端里分析项目、写代码、执行任务：

brew install --cask claude-code

安装后在项目目录运行 claude 即可启动。

Cursor：AI 原生编辑器

前面编辑器部分已经提到，Cursor 是目前 AI 辅助编码体验最好的编辑器，基于 VS Code，你的所有插件和设置可以直接迁移。

本地模型（进阶可选）

如果你想在本地运行 AI 模型（不依赖网络，数据不出本机）：

brew install --cask ollama

安装后运行一个轻量模型测试：

ollama run llama3.2

Docker 与容器

数据库、后端服务，全部用 Docker 跑，不污染本地环境。

安装 Docker Desktop

brew install --cask docker

启动 Docker Desktop，等待左下角变成绿色"Running"状态。

验证：

docker --version
docker compose version

一键启动本地数据库

创建一个 docker-compose.yml 文件，放在你喜欢的位置（比如 ~/dev/services/）：

# ~/dev/services/docker-compose.yml
services:
  postgres:
    image: postgres:16-alpine
    environment:
      POSTGRES_PASSWORD: postgres
      POSTGRES_USER: postgres
    ports:
      - "5432:5432"
    volumes:
      - postgres_data:/var/lib/postgresql/data

  adminer:
    image: adminer
    ports:
      - "8080:8080"

volumes:
  postgres_data:

启动：

docker compose up -d

访问 http://localhost:8080 打开 Adminer（数据库管理界面），服务器填 postgres，用户名和密码都是 postgres。

收尾与验证

做完以上步骤，运行这些命令验证环境是否正常：

# 基础工具
brew --version
git --version

# Node 环境
node --version    # 应该是 v22.x.x
pnpm --version

# Docker
docker --version
docker compose version

全部输出版本号，说明你的 Mac 开发环境已经就绪。

新建一个 Next.js 项目试试

pnpm create next-app@latest my-app
cd my-app
pnpm dev

打开 http://localhost:3000，看到 Next.js 欢迎页面，说明整个环境完全可用。