Mac新机开荒指南：从零搭建高效开发环境

刚拿到一台全新的MacBook，那种开箱的喜悦感还没褪去，就面临一个现实问题：如何快速搭建一个顺手的开发环境？作为每天与终端打交道的开发者，一个高效的工具链能让你事半功倍。本文将带你从零开始，一步步配置iTerm2终端、Homebrew包管理器，并实现无需第三方工具的rz/sz文件传输功能。

1. 开发环境基础配置

1.1 安装iTerm2：超越原生终端的利器

macOS自带的Terminal虽然能用，但iTerm2才是开发者的终极选择。它支持分屏、搜索高亮、自动补全等强大功能。安装非常简单：

1. 访问iTerm2官网下载最新版本
2. 拖动应用图标到Applications文件夹完成安装
3. 首次启动时，建议在Preferences > Profiles中设置自己喜欢的配色方案（比如Solarized Dark）

提示：在General > Preferences中勾选"Load preferences from a custom folder"，这样你的配置可以随时备份和迁移到新机器。

1.2 Homebrew：macOS缺失的包管理器

Homebrew是macOS上最受欢迎的包管理工具，可以轻松安装数千个开发工具和实用程序。安装命令虽然简单，但在国内可能会遇到网络问题：

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

如果遇到下载超时，可以尝试以下解决方案：

• 使用国内镜像源（替换原始安装脚本中的URL）
• 在夜间网络空闲时段重试
• 通过代理工具加速下载（需自行配置）

安装完成后，在终端输入brew doctor检查健康状况，应该会看到"Your system is ready to brew"的提示。

2. 文件传输方案：rz/sz配置详解

2.1 安装lrzsz工具

rz/sz是通过ZModem协议实现文件传输的经典工具，特别适合在SSH会话中传输文件。通过Homebrew安装非常简单：

bash复制brew install lrzsz

安装完成后，可以通过which rz和which sz确认命令路径，通常位于/opt/homebrew/bin/目录下（M1芯片Mac）或/usr/local/bin/（Intel芯片Mac）。

2.2 配置iTerm2的ZModem支持

要让iTerm2支持rz/sz，需要创建两个脚本文件并配置触发器：

1. 在/usr/local/bin/目录下创建两个脚本文件：

   • iterm2-send-zmodem.sh（用于发送文件）
   • iterm2-recv-zmodem.sh（用于接收文件）

2. 脚本内容示例（发送文件）：

bash复制#!/bin/bash
# 根据实际安装路径调整下面这行
/opt/homebrew/bin/sz "$@" -e -b

3. 给脚本添加执行权限：

bash复制chmod +x /usr/local/bin/iterm2-*.sh

2.3 设置iTerm2触发器

这是最关键的一步，配置iTerm2在特定情况下自动调用我们的脚本：

1. 打开iTerm2偏好设置(Preferences)
2. 进入Profiles > Default > Advanced > Triggers
3. 添加以下两个触发器：

3. 环境优化与实用技巧

3.1 解决常见安装问题

Homebrew安装过程中最常见的两个问题：

1. 下载超时：可以设置国内镜像源加速

   bash复制# 替换Homebrew源
   git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git
   

2. 权限问题：确保/usr/local目录有写入权限

   bash复制sudo chown -R $(whoami) /usr/local/*
   

3.2 iTerm2进阶配置

几个提升效率的iTerm2设置：

• Hotkey Window：设置一个全局快捷键快速呼出终端窗口
• Shell Integration：安装官方插件获得更多功能
• Status Bar：自定义状态栏显示有用信息
• Tmux集成：直接在iTerm2中使用tmux会话管理

3.3 rz/sz使用技巧

• 上传多个文件：rz -y可以多选文件
• 下载整个目录：先打包再下载更高效
• 传输大文件：考虑使用split分割文件

4. 完整工作流验证

让我们测试整个配置是否成功：

1. 连接到远程服务器：

   bash复制ssh username@remote-server
   

2. 在远程服务器上执行rz命令，应该会弹出本地文件选择对话框

3. 选择文件后，观察传输进度

4. 在远程服务器上执行sz filename测试下载功能

如果遇到问题，检查以下环节：

• lrzsz是否在远程服务器上安装
• 本地脚本路径是否正确
• 触发器正则表达式是否准确

5. 替代方案比较

虽然rz/sz很方便，但也有其他文件传输方式：

对于日常开发，rz/sz的便捷性往往是最佳选择，特别是需要频繁传输小文件时。

6. 环境备份与迁移

配置好的开发环境需要定期备份。推荐以下方法：

1. Homebrew备份：

   bash复制brew bundle dump --file=~/Brewfile
   

2. iTerm2配置备份：

   • 导出Preferences中的配置
   • 备份~/Library/Application Support/iTerm2目录

3. 脚本管理：
   将自定义脚本放在版本控制系统中（如GitHub）

这样在新机器上只需几分钟就能恢复完整的工作环境。

7. 终端生态扩展

基础环境搭建完成后，可以考虑添加这些效率工具：

• zsh + oh-my-zsh：更强大的shell环境
• autojump：快速目录跳转
• fzf：模糊查找工具
• htop：进程监控工具

这些都可以通过Homebrew一键安装：

bash复制brew install zsh autojump fzf htop

经过这些配置，你的Mac已经变身为一台高效的开发机器。记得定期更新工具链，保持环境的新鲜度和安全性。