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

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

macos
homebrew
colima
开发环境

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)”' >> ~/.zprofileeval ”$(/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 nvmmkdir -p ~/.nvm

写入 zsh 配置：

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

4.2 安装 Node LTS

nvm install --ltsnvm use --ltsnode -v

4.3 pnpm（Node.js 包管理器）

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

npm install -g pnpmpnpm setup

4.4 nrm（npm 源管理）

pnpm install -g nrmnrm use taobao

5. 开发工具链

5.1 MySQL 客户端

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

brew install mysql-client@8.0echo '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-switchbrew 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 infodocker 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 中追加：

# historyHISTFILE=~/.zsh_historyHISTSIZE=10000SAVEHIST=10000# 命令立即写入文件，而不是只在退出 shell 时写入setopt APPEND_HISTORYsetopt 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” 设置颜色方案为 desertcolorscheme desert” 启用行号set nu” 搜索时忽略大小写set ignorecase” 搜索结果高亮:set hlsearch

其它

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

参考

DeepSeek
Homebrew 官网