macOS开发环境配置：从零搭建完整工作流

无论是新入职还是换了新Mac，开发环境配置都是一件费时费力的事。本文提供一份从零开始的macOS开发环境配置指南，涵盖系统设置、包管理、终端配置、编辑器、语言环境和开发工具链，帮你用最短时间搭建出高效的工作流。

一、系统基础设置

在安装任何开发工具之前，先做好系统层面的优化。

1. 系统偏好设置

text

macOS推荐系统设置：

1. 触控板
   - 开启"轻点来点按"（Tap to click）
   - 开启"三指拖移"（辅助功能→指针控制→触控板选项）
   
2. 键盘
   - 按键重复速率：拉到最快
   - 按键重复前延迟：拉到最短
   - 快捷键：Caps Lock改为Control键
   
3. Dock
   - 自动隐藏Dock
   - 移除不常用的应用图标
   
4. Finder
   - 显示路径栏（Option+Cmd+P）
   - 显示状态栏
   - 默认显示所有文件扩展名
   - 新窗口默认打开主页

2. Xcode Command Line Tools

这是macOS开发的基础，很多工具依赖它。

bash

# 安装Xcode命令行工具
xcode-select --install

# 验证安装
xcode-select -p
# 应输出: /Library/Developer/CommandLineTools

二、包管理：Homebrew

Homebrew是macOS的包管理器，几乎所有开发工具都通过它安装。

安装Homebrew

bash

# 官方安装命令
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 配置环境变量（Apple Silicon Mac）
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# 验证安装
brew --version

Homebrew常用命令

bash

# 安装软件
brew install git wget curl tree jq

# 安装图形界面应用
brew install --cask google-chrome visual-studio-code

# 搜索软件
brew search python

# 更新Homebrew和软件
brew update          # 更新Homebrew本身
brew upgrade         # 升级所有已安装的软件
brew upgrade git     # 升级指定软件

# 清理旧版本
brew cleanup

# 查看已安装的软件
brew list
brew list --cask

三、终端配置

终端是开发者使用最频繁的工具，值得花时间配置好。

1. iTerm2

比系统自带的Terminal功能更强大。

text

iTerm2推荐设置：

Preferences → General:
  - Closing: 取消"Confirm closing multiple tabs"
  - Startup: 设置默认窗口大小

Preferences → Profiles → Default:
  - Text: 使用等宽字体（推荐JetBrains Mono / Fira Code）
  - 字体大小: 14-16px
  - Colors: 选择暗色主题（推荐Dracula或Nord）
  - Keys: 开启"Natural text editing"（自然编辑模式）
  
快捷键:
  - Cmd+T: 新建标签页
  - Cmd+D: 垂直分屏
  - Cmd+Shift+D: 水平分屏
  - Cmd+数字: 切换标签页
  - Option+Cmd+方向键: 切换分屏

2. Oh My Zsh

Zsh配置框架，提供主题、插件和便捷配置。

bash

# 安装Oh My Zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

3. Powerlevel10k主题

bash

# 安装Powerlevel10k主题
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
  ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

# 在~/.zshrc中设置主题
# ZSH_THEME="powerlevel10k/powerlevel10k"

# 重新加载配置
source ~/.zshrc

# 会自动启动配置向导，按提示选择即可

4. Zsh插件

bash

# 安装zsh-autosuggestions（自动建议）
git clone https://github.com/zsh-users/zsh-autosuggestions \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

# 安装zsh-syntax-highlighting（语法高亮）
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

bash

# ~/.zshrc 插件配置
plugins=(
  git                    # Git别名和补全
  z                      # 智能目录跳转
  docker                 # Docker补全
  kubectl                # K8s补全
  zsh-autosuggestions    # 自动建议
  zsh-syntax-highlighting # 语法高亮
)

5. 完整的.zshrc配置

bash

# ~/.zshrc 核心配置

# Oh My Zsh
export ZSH="$HOME/.oh-my-zsh"
ZSH_THEME="powerlevel10k/powerlevel10k"
plugins=(git z docker kubectl zsh-autosuggestions zsh-syntax-highlighting)
source $ZSH/oh-my-zsh.sh

# 常用别名
alias ll='ls -lah'
alias gs='git status'
alias gd='git diff'
alias gp='git push'
alias gl='git log --oneline --graph --decorate -20'
alias dc='docker compose'
alias k='kubectl'
alias ports='lsof -i -P -n | grep LISTEN'

# 环境变量
export PATH="/opt/homebrew/bin:$PATH"
export PATH="$HOME/.local/bin:$PATH"
export EDITOR='code'
export LANG=en_US.UTF-8

# NVM（Node版本管理）
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

# 历史记录
HISTSIZE=10000
SAVEHIST=10000
setopt SHARE_HISTORY          # 多终端共享历史
setopt HIST_IGNORE_DUPS       # 忽略重复命令
setopt HIST_IGNORE_SPACE      # 忽略空格开头的命令

四、编辑器：VS Code

1. 安装与基础配置

bash

brew install --cask visual-studio-code

json

// VS Code settings.json 推荐配置
{
  // 编辑器
  "editor.fontSize": 14,
  "editor.fontFamily": "'JetBrains Mono', 'Fira Code', monospace",
  "editor.fontLigatures": true,
  "editor.tabSize": 2,
  "editor.formatOnSave": true,
  "editor.minimap.enabled": false,
  "editor.wordWrap": "on",
  "editor.bracketPairColorization.enabled": true,
  
  // 文件
  "files.autoSave": "onFocusChange",
  "files.trimTrailingWhitespace": true,
  "files.insertFinalNewline": true,
  
  // 终端
  "terminal.integrated.fontSize": 13,
  "terminal.integrated.fontFamily": "'JetBrains Mono'",
  
  // 搜索
  "search.exclude": {
    "**/node_modules": true,
    "**/dist": true,
    "**/.git": true
  },
  
  // Git
  "git.autofetch": true,
  "git.confirmSync": false,
  
  // 工作台
  "workbench.colorTheme": "One Dark Pro",
  "workbench.iconTheme": "material-icon-theme",
  "workbench.startupEditor": "none"
}

2. 必装插件

text

通用插件：
- Prettier             代码格式化
- ESLint               JS/TS代码检查
- GitLens              Git增强
- Error Lens           行内错误提示
- Code Spell Checker   拼写检查
- Material Icon Theme  文件图标
- One Dark Pro         暗色主题

语言插件（按需安装）：
- Python               Python支持
- Go                   Go语言支持
- Rust                 Rust支持
- Tailwind CSS         Tailwind智能提示
- Docker               Dockerfile支持
- YAML                 YAML支持

效率插件：
- Git History          Git历史可视化
- Path Intellisense    路径自动补全
- auto-close-tag       自动闭合标签
- Thunder Client       内置API测试

五、语言环境配置

1. Node.js (nvm)

bash

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 安装Node.js LTS版本
nvm install --lts
nvm use --lts

# 设置默认版本
nvm alias default 'lts/*'

# 包管理器
npm install -g pnpm    # 推荐pnpm，速度快、节省空间

2. Python (pyenv)

bash

# 安装pyenv
brew install pyenv

# 配置shell（添加到~/.zshrc）
export PYENV_ROOT="$HOME/.pyenv"
[[ -d $PYENV_ROOT/bin ]] && export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

# 安装Python版本
pyenv install 3.12.0
pyenv global 3.12.0

# 安装常用工具
pip install pipx
pipx install poetry    # Python依赖管理
pipx install ruff      # 代码检查和格式化

3. Go

bash

brew install go

# 配置环境变量
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

# 安装常用工具
go install golang.org/x/tools/gopls@latest
go install github.com/go-delve/delve/cmd/dlv@latest

4. Rust

bash

# 安装rustup（Rust版本管理器）
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 验证
rustc --version
cargo --version

# 安装组件
rustup component add rustfmt clippy

六、开发工具链

1. Git配置

bash

# 基础配置
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
git config --global init.defaultBranch main
git config --global pull.rebase true

# 常用别名
git config --global alias.st status
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.lg "log --oneline --graph --decorate -20"

# SSH密钥
ssh-keygen -t ed25519 -C "your.email@example.com"
# 将公钥添加到GitHub: cat ~/.ssh/id_ed25519.pub

2. Docker

bash

brew install --cask docker

# 启动Docker Desktop后验证
docker --version
docker compose version

# Docker配置建议：
# Docker Desktop → Settings → Resources:
#   - CPUs: 4-8
#   - Memory: 4-8 GB
#   - 开启Use Rosetta for x86/amd64 emulation（Apple Silicon）

3. 数据库工具

bash

# 命令行工具
brew install postgresql@16
brew install redis

# 图形界面工具
brew install --cask dbeaver-community    # 通用数据库客户端
brew install --cask tableplus            # 更现代的数据库客户端

# 启动数据库服务
brew services start postgresql@16
brew services start redis

七、效率工具

1. Raycast

替代Spotlight的效率启动器。

text

Raycast必装扩展：
- Clipboard History     剪贴板历史
- Window Management      窗口管理
- Color Picker           取色器
- Currency Converter     汇率转换
- GitHub                 GitHub搜索
- Docker                 Docker管理

2. Rectangle

窗口管理工具，用快捷键调整窗口位置和大小。

text

Rectangle核心快捷键：
Ctrl+Option+方向键    → 半屏（左/右/上/下）
Ctrl+Option+Enter     → 最大化
Ctrl+Option+C         → 居中
Ctrl+Option+左/右     → 左右半屏

3. 其他推荐

bash

brew install --cask obsidian      # 笔记工具
brew install --cask notion        # 团队协作
brew install --cask postman       # API测试（或用Thunder Client替代）
brew install --caskProxyman       # HTTP抓包
brew install --cask keepingyouawake  # 防休眠

八、配置自动化与云同步

用Brewfile管理安装的软件

bash

# 导出当前安装的所有软件
brew bundle dump --file=~/Brewfile

# 在新Mac上一键恢复
brew bundle install --file=~/Brewfile

Dotfiles管理

bash

# 使用Git管理配置文件
mkdir ~/dotfiles
cd ~/dotfiles

# 创建符号链接管理脚本
cat > install.sh << 'EOF'
#!/bin/bash
ln -sf ~/dotfiles/.zshrc ~/.zshrc
ln -sf ~/dotfiles/.gitconfig ~/.gitconfig
ln -sf ~/dotfiles/.vimrc ~/.vimrc
echo "Dotfiles installed!"
EOF
chmod +x install.sh

总结

完整的macOS开发环境配置可以归纳为以下清单：

text

环境配置Checklist：

□ Xcode Command Line Tools
□ Homebrew 包管理器
□ iTerm2 + Oh My Zsh + Powerlevel10k
□ VS Code + 必装插件
□ Git 配置 + SSH密钥
□ Node.js (nvm) + pnpm
□ Python (pyenv) + poetry
□ Go / Rust (按需)
□ Docker Desktop
□ 数据库 (PostgreSQL/Redis)
□ Raycast 效率启动器
□ Rectangle 窗口管理
□ Brewfile + Dotfiles 云同步

花半天时间按照本文配置好环境，后续每天都能省下大量时间。更重要的是，通过Brewfile和Dotfiles管理，换新Mac时只需一条命令就能恢复全部配置。

希望这份指南能帮助你搭建出趁手的开发环境！

一、系统基础设置

1. 系统偏好设置

2. Xcode Command Line Tools

二、包管理：Homebrew

安装Homebrew

Homebrew常用命令

推荐通过Homebrew安装的工具

三、终端配置

1. iTerm2

2. Oh My Zsh

3. Powerlevel10k主题

4. Zsh插件

5. 完整的.zshrc配置

四、编辑器：VS Code

1. 安装与基础配置

2. 必装插件

五、语言环境配置

1. Node.js (nvm)

2. Python (pyenv)

3. Go

4. Rust

六、开发工具链

1. Git配置

2. Docker

3. 数据库工具

七、效率工具

1. Raycast

2. Rectangle

3. 其他推荐

八、配置自动化与云同步

用Brewfile管理安装的软件

Dotfiles管理

总结

💬 评论区 (0)