跳转至

MacOS 开发常用软件安装与配置

2026-06-21 by dongnan

前置说明

本文是《生产力换新 - 再见Ubuntu 你好 MacOS》的续篇，聚焦第二步：在新 MacBook Air M5 上安装开发所需软件。

原则：能用 Homebrew 装的优先用 brew，Docker 用轻量化方案 Colima 替代 Docker Desktop，避免资源浪费。

1. Homebrew 包管理器

选择 Homebrew 而非 MacPorts，理由：

  • 预编译包（bottle），安装速度快
  • Apple Silicon 原生支持，安装路径 /opt/homebrew
  • 生态最主流，社区和教程最多

安装

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

Apple Silicon 安装完成后配置 PATH：

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

2. 基础开发工具

brew install git wget curl tree unzip jq yq htop tmux
命令 用途
git 版本控制，代码管理
wget 文件下载，支持断点续传
curl 网络请求调试，发送 HTTP 请求
tree 以树状结构展示目录层级
unzip 解压 .zip 文件
jq 命令行处理 JSON 数据
yq 命令行处理 YAML 数据
htop 交互式进程监控，比 top 更直观
tmux 终端复用，一个窗口管理多个会话

3. Python 环境

使用 uv 做 Python 包管理（比 pip 更快、依赖解析更稳定）：

brew install uv

验证：

uv --version

注意：编译 Python 包需要 Xcode Command Line Tools，如果尚未安装，先执行： xcode-select --install

4. Node 环境

4.1 nvm（Node 版本管理器）

nvm（Node Version Manager）允许在同一台机器上安装和切换多个 Node.js 版本，不同项目可以锁定各自的 Node 版本，互不干扰。

brew install nvm
mkdir -p ~/.nvm

写入 zsh 配置：

echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && . "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && . "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"' >> ~/.zshrc
source ~/.zshrc

4.2 安装 Node LTS

nvm install --lts
nvm use --lts
node -v

4.3 pnpm（Node.js 包管理器）

pnpm 是 npm / yarn 的替代方案，采用硬链接 + 符号链接的存储方式，安装速度快、磁盘占用少，且严格遵循依赖隔离。

npm install -g pnpm
pnpm setup

4.4 nrm（npm 源管理）

pnpm install -g nrm
nrm use taobao

5. 开发工具链

5.1 MySQL 客户端

只需命令行客户端连接远程数据库，不需要本地运行 MySQL 服务：

brew install mysql-client@8.0
echo 'export PATH="/opt/homebrew/opt/mysql-client@8.0/bin:$PATH"' >> ~/.zshrc

5.2 Redis 客户端

redis 包自带 redis-cli，用于连接远程 Redis 服务：

brew install redis

安装后仅使用 redis-cli 即可，无需启动本地 Redis 服务（brew services start redis）。

5.3 cc-switch

Claude 配置切换程序

brew install --cask cc-switch
brew upgrade --cask cc-switch

--cask 参数说明：Homebrew 将软件包分为两类 —— formula（命令行工具）和 cask（GUI 应用）。cc-switch 作为 macOS 原生应用分发，属于 cask，需要加 --cask 来告诉 brew 按 GUI 应用的方式安装和管理。

6. 容器环境

Docker Desktop 资源开销大，16GB 内存推荐用 Colima 替代 Docker Desktop :

brew install colima docker docker-compose

启动 Colima（参数针对 16GB 内存优化）：

colima start --cpu 4 --memory 5 --disk 50

验证：

docker info
docker ps

重要：拉取镜像时务必使用 ARM64 原生版本（如 mysql:8.0 已原生支持 ARM），避免 x86_64 转译导致 CPU 飙升和卡顿。

7. 编辑器

7.1 VSCode

brew install --cask visual-studio-code

7.2 CotEditor

专门为 macOS 原生打造的开源纯文本编辑器（Swift 编写）。启动速度极快，内存占用极低（开几十个文件也只占几十 MB）。适合快速查看 / 编辑单个文件。

Mac App Store 免费下载。

8. Claude Code

pnpm install -g @anthropic-ai/claude-code

安装 Playwright 浏览器自动化依赖（Claude Code 部分功能需要）：

pnpm exec playwright install chromium

9. 网络工具

brew install telnet nmap ipcalc openvpn iproute2mac sqlmap
命令 用途
telnet 测试远程端口是否可达
nmap 网络扫描与端口探测
ipcalc IP 子网计算
openvpn VPN 客户端
iproute2mac 在 macOS 上提供 Linux ip 命令的等价功能
sqlmap SQL 注入检测与利用工具

10. Shell 配置

10.1 Zsh 历史记录

默认 history 命令只显示最近 16 条。在 ~/.zshrc 中追加：

# history
HISTFILE=~/.zsh_history
HISTSIZE=10000
SAVEHIST=10000
# 命令立即写入文件，而不是只在退出 shell 时写入
setopt APPEND_HISTORY
setopt INC_APPEND_HISTORY
# 合并多个终端历史
setopt SHARE_HISTORY

修改后生效：

source ~/.zshrc

使用 history 0 可查看完整历史记录（从第一条开始）。

10.2 常用别名

alias ll='ls -alF'
alias la='ls -A'
alias l='ls -CF'

10.3 Vim 配置

macOS 自带 vim 默认无语法高亮。创建 ~/.vimrc：

" 启用语法高亮
syntax on

" 设置颜色方案为 desert
colorscheme desert

" 启用行号
set nu

" 搜索时忽略大小写
set ignorecase

" 搜索结果高亮
:set hlsearch

其它

  1. ARM64 原生镜像：Docker 容器务必使用 ARM64 原生镜像，避免跨架构转译带来的 CPU 飙升。
  2. 5000 端口占用：macOS 的「隔空播放接收器」默认占用 5000 端口，需在 系统设置 → 通用 → 隔空播放与接力 中关闭。
  3. 浏览器标签页恢复失效：需在 系统设置 → 桌面与台前调度 中关闭「退出应用程序时关闭窗口」。
  4. Swap 监控：通过「活动监视器」→ 内存 → 列 → 勾选「压缩内存」，可查看各进程的内存占用情况。

参考

回到页面顶部