程序员新 Mac 从零搭建开发环境：2026 完整手册 摘要每年换新 Mac 或重装系统时搭建开发环境需要半天到一天——但如果你有一个明确的清单和自动化脚本2 小时就能从开机到生产力就绪。本文记录了从 macOS 基础设置 → Homebrew 包管理 → 终端美化iTerm2 Oh My Zsh→ VS Code 配置 → Git/Node/Python 开发环境 → 效率工具补位SpacePeek/Raycast/Rectangle的完整流程。每一步附具体的命令和配置选项文末提供一键脚本汇总。本文信息基于 macOS 15.0 Sequoia / MacBook Pro M3 Pro 从出厂状态重新配置的全过程记录。如果你刚拿到新 Mac 或准备重装系统这篇可以当作操作手册。一、前言搭环境这件事每次都要重新学一遍我换 Mac 最烦的不是搬数据——是搭环境。Homebrew 的安装命令每次都要去官网复制。Oh My Zsh 装完之后总要重新搜怎么换主题。VS Code 的插件列表每次都是凭记忆装每次都会漏一两个。Git 的 user.name 和 user.email 不配的话第一行 commit 就是错的。这些不是技术难度高是记忆负担重。所以这次我把自己从出厂状态到可开始写代码的全过程记录了下来——下次再搭环境对着这个清单走就行。阅读收益一份可复现的开发环境搭建清单按优先级排列每个工具的推荐配置和踩坑提示文末一键脚本可以直接跑二、搭建流程总览第 1 步系统基础设置10 分钟 第 2 步Homebrew 包管理器5 分钟 第 3 步终端环境20 分钟 第 4 步VS Code 编辑器15 分钟 第 5 步Git / Node / Python 开发环境20 分钟 第 6 步效率工具补位15 分钟 第 7 步验证 备份配置10 分钟三、逐步详解第 1 步系统基础设置10 分钟这部分不需要敲命令但影响你之后几个月的使用体验。强制操作# 1. 显示 Finder 隐藏文件defaultswritecom.apple.finder AppleShowAllFiles-booltruekillallFinder# 2. 显示完整路径Finder 标题栏显示完整路径defaultswritecom.apple.finder _FXShowPosixPathInTitle-booltruekillallFinder# 3. 允许从任何来源安装 App非 App Store 工具需要sudospctl --master-disable# 4. 关闭下载的 App 首次打开确认省去每次点确认defaultswritecom.apple.LaunchServices LSQuarantine-boolfalse可选但推荐系统设置 → 触控板 → 开启「轻点来点按」和「三指拖移」系统设置 → 键盘 → 快捷键 → Spotlight → 取消⌘Space为 Raycast 让路系统设置 → Dock → 自动显示和隐藏 Dock给终端和编辑器更多屏幕空间第 2 步Homebrew —— macOS 的应用商店5 分钟Homebrew 是你之后安装一切命令行工具和 App 的基础。别跳过这步。# 安装 Homebrew/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 安装完成后按终端提示把 Homebrew 加入 PATHechoeval $(/opt/homebrew/bin/brew shellenv)~/.zprofileeval$(/opt/homebrew/bin/brew shellenv)# 验证brew doctor装完 Homebrew 之后先装这些底层依赖# git — macOS 自带的是旧版需要升级brewinstallgit# wget — 比 curl 更友好的下载工具brewinstallwget# tree — 终端里可视化目录结构brewinstalltree# jq — 命令行 JSON 处理调试 API 必备brewinstalljq踩坑提示⚠️ Apple Silicon Mac 上 Homebrew 安装路径是/opt/homebrewIntel Mac 是/usr/local。如果你从 Intel Mac 迁移数据到 Apple Silicon旧的 Homebrew 路径会失效需要重新安装。⚠️brew doctor如果有 warning按提示一一修复后再装其他包。积压的 warning 会在后续某天突然导致某个包编译失败。第 3 步终端环境 —— 写代码最常待的地方20 分钟3.1 装 iTerm2macOS 自带的终端不是不能用但 iTerm2 的标签管理、分屏、搜索、粘贴历史、全局热键呼出——每一项都让你回不去。brewinstall--caskiterm2装完之后做一项关键配置iTerm2 → Settings → Profiles → Keys → Key Mappings → Presets → 选择「Natural Text Editing」。这会让⌥←跳一个单词、⌘←跳到行首——和你在 VS Code 里的操作习惯一致。3.2 装 Oh My ZshmacOS 从 Catalina 开始默认 shell 就是 zsh但裸 zsh 不够好用。Oh My Zsh 提供了 300 插件、自动补全、主题系统、Git 状态提示。sh-c$(curl-fsSLhttps://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)3.3 配置 ~/.zshrc装完 Oh My Zsh 之后编辑~/.zshrc# 1. 换一个简洁的主题ZSH_THEMEagnoster# 推荐 agnoster 或 powerlevel10k# 2. 启用常用插件plugins(git# git 命令补全和别名zsh-autosuggestions# 灰色提示之前输入过的命令zsh-syntax-highlighting# 命令语法高亮绿色正确/红色错误brew# brew 命令补全docker# docker 命令补全)# 3. 安装两个需要额外下载的插件gitclone https://github.com/zsh-users/zsh-autosuggestions${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestionsgitclone https://github.com/zsh-users/zsh-syntax-highlighting.git${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting# 4. 重新加载配置source~/.zshrc踩坑提示⚠️powerlevel10k主题需要先安装字体MesloLGS NF否则终端会显示乱码方框。或者先用agnoster不需要额外字体。⚠️zsh-autosuggestions的灰色提示文本按→键右箭头逐字接受按⌃E跳到行尾全部接受。第 4 步VS Code —— 最核心的生产力工具15 分钟4.1 安装brewinstall--caskvisual-studio-code4.2 开启 Settings SyncVS Code → 左下角齿轮 → Settings Sync → 用 GitHub 账号登录。这一步会把你的设置、快捷键、插件列表全部同步下来。如果你之前在新 Mac 上登录过——所有配置自动回来不需要重新装。4.3 如果你没有之前的同步数据手动装这些核心插件# 在 VS Code 终端里执行装完 VS Code 后 code 命令自动可用code --install-extension eamodio.gitlens# Git 增强code --install-extension esbenp.prettier-vscode# 代码格式化code --install-extension dbaeumer.vscode-eslint# ESLintcode --install-extension ms-python.python# Pythoncode --install-extension ms-vscode.vscode-typescript-next# TypeScriptcode --install-extension github.copilot# GitHub Copilotcode --install-extension github.copilot-chat# Copilot Chat4.4 一个必改的设置⌘,打开设置 → 搜索 “auto save” → 将Files: Auto Save改为afterDelay延迟设为 1000ms。这样你不再需要⌘S——切到 Chrome 时 VS Code 自动帮你保存。一个月后你会忘了⌘S这个快捷键。第 5 步Git / Node / Python 开发环境20 分钟5.1 Git 初始配置gitconfig--globaluser.name你的名字gitconfig--globaluser.email你的邮箱gitconfig--globalinit.defaultBranch main# 默认分支改用 maingitconfig--globalcore.autocrlf input# macOS 换行符处理5.2 Node.js用 nvm 管理版本不要直接用brew install node——以后切换 Node 版本时会很麻烦。用 nvm。# 安装 nvmcurl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh|bash# 安装最新 LTS 版 Nodenvminstall--ltsnvm use--lts# 验证node-vnpm-v5.3 Python用 pyenv 管理版本# 安装 pyenvbrewinstallpyenv# 加入 PATHechoeval $(pyenv init -)~/.zshrcsource~/.zshrc# 安装最新 Pythonpyenvinstall3.12pyenv global3.12# 验证python--version5.4 Docker按需brewinstall--caskdocker安装后启动 Docker Desktop。建议在设置里限制内存上限默认可能会吃掉 8GB。第 6 步效率工具补位15 分钟开发环境搭好了但 macOS 有些功能缺失会影响你每天的编码效率。以下是程序员最需要的几个。6.1 SpacePeek按空格看文件夹大小程序员的 Finder 使用频率是普通用户的 10 倍——node_modules有多大这个项目目录总共占多少空间之前你只能终端du -sh或者右键 → 显示简介。App Store 搜「SpacePeek」免费下载。安装后选中任意文件夹按空格直接看到总大小、文件数量和饼图。项目文件夹、Downloads、Library——随手按空格就是诊断。装完后必须去系统设置 → 通用 → 登录项与扩展 → Quick Look → 手动打开 SpacePeek 开关。6.2 Raycast替代 Spotlight⌥Space呼出搜索框启动 App、搜索文件、剪贴板历史、窗口管理、进程管理、emoji 搜索。免费版已经覆盖了 Alfred 的大部分付费功能。如果你在系统设置里把 Spotlight 的⌘Space禁用了把 Raycast 设为⌘Space会更顺手。brewinstall--caskraycast6.3 Rectangle快捷键窗口管理程序员标配外接显示器。⌃⌥←窗口左半屏、⌃⌥→右半屏不需要手动对齐。brewinstall--caskrectangle第 7 步验证 备份配置10 分钟验证清单git--version# 应该 ≥ 2.40node-v# 应该 ≥ 20 LTSpython--version# 应该 ≥ 3.12brew doctor# 应该没有 errorcode--version# 应该能正常输出备份配置# 备份 Homebrew 已安装的包列表brew bundle dump--file~/Brewfile# 备份 VS Code 插件列表code --list-extensions~/vscode-extensions.txt# 备份 Git 全局配置cp~/.gitconfig ~/gitconfig-backup把这三个文件Brewfile、vscode-extensions.txt、gitconfig-backup放到你的 iCloud 或 GitHub 上。下次重装系统一条命令就能恢复所有包brew bundleinstall--file~/Brewfile四、一键脚本汇总以下是把本文所有命令合并在一起的可执行脚本。复制、粘贴、泡杯咖啡等着。#!/bin/bash# 新 Mac 开发环境一键搭建脚本# 适用macOS Sequoia 15.0 / Apple Silicon# 系统设置 defaultswritecom.apple.finder AppleShowAllFiles-booltruedefaultswritecom.apple.finder _FXShowPosixPathInTitle-booltruekillallFinder defaultswritecom.apple.LaunchServices LSQuarantine-boolfalse# Homebrew /bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)echoeval $(/opt/homebrew/bin/brew shellenv)~/.zprofileeval$(/opt/homebrew/bin/brew shellenv)# 基础工具 brewinstallgitwgettree jq# 终端 brewinstall--caskiterm2sh-c$(curl-fsSLhttps://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)--unattendedgitclone https://github.com/zsh-users/zsh-autosuggestions${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestionsgitclone https://github.com/zsh-users/zsh-syntax-highlighting.git${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting# 编辑器 brewinstall--caskvisual-studio-code# 语言环境 curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh|bashbrewinstallpyenv# 效率工具 brewinstall--caskraycast rectangleecho✅ 开发环境搭建完成echo⚠️ 请手动操作echo 1. App Store 安装 SpacePeek免费echo 2. 系统设置 → Quick Look → 打开 SpacePeek 开关echo 3. nvm install --lts nvm use --ltsecho 4. pyenv install 3.12 pyenv global 3.12echo 5. git config --global user.name 你的名字echo 6. git config --global user.email 你的邮箱五、总结三点核心搭环境最费时的不是装软件是回忆上次怎么装的。Homebrew 一键安装、Oh My Zsh 插件列表、VS Code Settings Sync——这三样把安装变成了复制粘贴。文末的脚本下次可以直接跑。程序员 Mac 和普通 Mac 的差距就在终端和编辑器。iTerm2 Oh My Zsh VS Code Git/Node/Python 堆栈——这是你的生产力核心。后面的 SpacePeek/Raycast/Rectangle 是锦上添花——文件大小感知、键盘启动、窗口管理减少的不是技术操作的时间而是找寻和切换的时间。备份配置和搭建环境一样重要。Brewfile VS Code 插件列表 Git 配置 你花 2 小时搭起来的环境下次 15 分钟就能复现。涉及的工具速查工具类别安装方式Homebrew包管理器brew.shiTerm2终端brew install --cask iterm2Oh My ZshZsh 配置ohmyz.shVS Code编辑器brew install --cask visual-studio-codeGit版本控制brew install gitnvmNode 版本管理nvm-sh/nvmpyenvPython 版本管理brew install pyenvSpacePeek文件夹大小速查App StoreRaycast启动器brew install --cask raycastRectangle窗口管理brew install --cask rectangle测试环境macOS 15.0 Sequoia / MacBook Pro M3 Pro / 2026 年 7 月你的开发环境搭建清单里有没有本文漏掉的必备工具评论区补上——我加到下一版脚本里。