Mac Vibe Coding 01：新机器从零搭建开发底座

这篇只解决一件事：一台新 Mac 到手，如何把它搭成能进行 Vibe Coding 的本地开发底座。

这里的“底座”不是装几个漂亮 App，而是让它具备这些能力：

• 能安装和升级开发工具。
• 能拉 GitHub 仓库。
• 能跑 Node / Python 项目。
• 能快速搜索代码。
• 能让 AI 编码代理调用本地命令。
• 能验证项目是否真的运行。

下面按步骤来。

0. 先定一个原则

新机器不要一上来装一堆工具。

正确顺序是：

系统基础 -> 命令行 -> 包管理器 -> Git -> 语言运行时 -> 搜索/JSON 工具 -> 项目目录 -> AI 工具

如果顺序反了，后面遇到问题时，你会分不清是系统权限、PATH、包管理器、Node 版本还是 AI 工具的问题。

1. 系统语言建议改成英文

不是为了装酷，而是为了排错。

开发环境里的报错、菜单项、系统权限、终端提示大多以英文为准。英文系统能减少翻译层带来的搜索损耗。

路径：

System Settings -> General -> Language & Region

建议：

• Preferred Languages：English 优先。
• Region：按你的实际使用选择。需要海外服务时可考虑 United States。

改完后重启一次。

2. 打开 Terminal 并确认 shell

打开 Terminal 后先看 shell：

echo $SHELL
zsh --version

现在 macOS 默认通常是 zsh。如果不是，也不用急着改，先确认项目能跑。

我会创建一个专门放项目的目录：

mkdir -p ~/Projects
mkdir -p ~/Projects/labs
mkdir -p ~/Projects/archive

我的习惯是：

• ~/Projects 放长期项目。
• ~/Projects/labs 放实验项目。
• ~/Projects/archive 放不再活跃但不想删除的东西。

AI 编码代理最好不要在桌面或下载目录里乱跑。项目目录清楚，权限和 Git 边界也更清楚。

3. 安装 Xcode Command Line Tools

执行：

xcode-select --install

安装完成后验证：

xcode-select -p
git --version

如果 xcode-select -p 能输出路径，说明基础开发工具可用。

常见问题：

• 弹窗安装很慢：等，不要同时跑多个安装脚本。
• 提示 license：执行 sudo xcodebuild -license，按提示确认。
• 系统升级后 Git 异常：重新运行 xcode-select --install 或检查软件更新。

4. 安装 Homebrew

官方安装命令以 Homebrew 官网为准。常见形式是：

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

Apple Silicon 机器安装后通常需要把 Homebrew 加入 shell 环境。按安装结束时提示执行，通常类似：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

验证：

which brew
brew --version
brew doctor

如果 which brew 输出 /opt/homebrew/bin/brew，说明 Apple Silicon 路径正常。

5. 安装基础工具

我会先装这一组：

brew install git node pnpm python uv ripgrep jq wget tree

解释一下每个工具的用途：

• git：版本控制。
• node：前端和很多 CLI 工具依赖它。
• pnpm：Node 项目包管理。
• python：脚本、数据处理、服务端工具。
• uv：Python 包和虚拟环境管理。
• ripgrep：高速搜索代码。
• jq：命令行处理 JSON。
• wget：下载脚本或文件。
• tree：快速查看目录结构。

验证：

git --version
node -v
pnpm -v
python3 --version
uv --version
rg --version
jq --version
wget --version
tree --version

这一步不要跳。Vibe Coding 里 AI 会频繁建议跑命令，你必须知道这些底层工具是否真的存在。

6. 给 Zsh 加最低限度增强

Zsh 不需要折腾成主题展览，但两个插件值得装：命令自动建议和语法高亮。

如果你已经装了 Oh My Zsh，可以执行：

git clone https://github.com/zsh-users/zsh-autosuggestions.git \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

然后编辑 ~/.zshrc：

code ~/.zshrc

把 plugins 改成：

plugins=(git zsh-autosuggestions zsh-syntax-highlighting)

重新加载：

source ~/.zshrc

验证方法很简单：

• 输入一条以前用过的命令，看是否出现灰色自动建议。
• 输入错误命令，看是否有颜色提示。

如果你不想装 Oh My Zsh，也可以先跳过。Vibe Coding 需要的是稳定命令行，不是复杂主题。

7. 建立 Terminal 和 Finder 的双向跳转

AI 编码时经常需要在路径、文件和命令之间切换。Terminal 和 Finder 互通非常重要。

从 Terminal 打开当前目录：

open .

打开某个文件：

open README.md

查看当前路径：

pwd

把当前路径复制到剪贴板：

pwd | pbcopy

从 Finder 到 Terminal，可以先用系统内置方式：

Finder 选中文件夹 -> 右键 -> Services -> New Terminal at Folder

如果菜单里没有，去这里打开：

System Settings -> Keyboard -> Keyboard Shortcuts -> Services

把 New Terminal at Folder 勾上。这个能力不花哨，但很关键：当你在 Finder 里找到项目文件夹后，可以立刻进入命令行环境。

我的建议是先掌握这组最小动作：

pwd
ls
open .
cd ~/Projects
rg "关键词" .

这比装一个复杂启动器更重要。

8. 配置 Git 身份

设置 Git 用户信息：

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

验证：

git config --global --list

建议再设置默认分支名：

git config --global init.defaultBranch main

9. 配 SSH Key

如果你用 GitHub，建议配置 SSH。

生成 key：

ssh-keygen -t ed25519 -C "你的邮箱"

一路回车即可。然后启动 ssh-agent：

eval "$(ssh-agent -s)"

把 key 加进去：

ssh-add ~/.ssh/id_ed25519

复制公钥：

pbcopy < ~/.ssh/id_ed25519.pub

到 GitHub：

Settings -> SSH and GPG keys -> New SSH key

测试：

ssh -T [email protected]

看到类似 “successfully authenticated” 就可以。

10. 准备一个测试项目

不要直接拿复杂项目测试新环境。先用一个最小项目验证。

cd ~/Projects/labs
mkdir mac-vibe-check
cd mac-vibe-check
git init
pnpm init

创建一个简单脚本：

mkdir -p scripts
printf 'console.log("Mac Vibe Coding ready")\n' > scripts/check.js

修改 package.json，加入：

{
  "scripts": {
    "check": "node scripts/check.js"
  }
}

运行：

pnpm check

提交：

git add .
git commit -m "Initialize Mac vibe coding check"

这一步的意义是确认 Git、Node、pnpm、文件写入都正常。

11. 给 AI 代理准备边界

以后使用 Codex、Claude Code、Copilot CLI 时，不要让它们在没有 Git 的目录里随意改。

每个项目至少要有：

git status

能正常工作。

再建一个项目说明文件：

printf '# Project Notes\n\n- Run checks before commit.\n- Do not overwrite user changes.\n' > AGENTS.md

很多 AI 编码代理会读取类似 AGENTS.md、README.md、.github/copilot-instructions.md 这样的项目说明。即使某个工具不自动读取，它也是给你自己和 AI 的上下文锚点。

12. 最小验证清单

新 Mac 底座搭完后，跑一遍：

brew doctor
git --version
node -v
pnpm -v
python3 --version
uv --version
rg --version
jq --version
wget --version
tree --version
ssh -T [email protected]

再进入测试项目：

cd ~/Projects/labs/mac-vibe-check
pnpm check
git status

如果这些都正常，再装 AI 编码代理。

我的取舍

我不会在第一天就装满所有工具。

新机器最重要的是可恢复、可验证、可解释。等这套底座稳定后，再引入 Codex、Claude Code、Copilot CLI、VS Code、Playwright、Hugo。

Vibe Coding 的底层不是“模型很强”，而是你给模型的本地环境足够干净。环境乱，AI 只会把混乱放大。