如果你想在 Mac 上获得更顺手的终端体验，可以组合使用 iTerm2、Zsh 原生补全、zsh-autosuggestions、zsh-syntax-highlighting 和 zoxide。配置完成后，终端将支持命令自动建议、语法高亮、Tab 补全和智能目录跳转。

本文使用 brew --prefix 自动识别 Homebrew 安装路径，完整介绍安装步骤、.zshrc 配置、功能验证和常见问题处理方法。

配置完成后能获得什么

组件	主要作用
iTerm2 Shell Integration	让 iTerm2 识别提示符、命令范围、退出状态、命令历史和最近目录
Zsh compinit	提供命令、文件和目录的 Tab 补全
zsh-autosuggestions	根据历史记录显示灰色命令建议
zsh-syntax-highlighting	输入时区分有效命令、无效命令和 Shell 语法
zoxide	学习访问过的目录，通过 z 或 zi 快速跳转
fzf（可选）	为 zi 提供交互式模糊搜索界面

适用环境与准备工作

本文适用于：

• 已安装 macOS 的 Mac
• 已安装 iTerm2
• 已安装 Homebrew
• 使用 macOS 默认的 Zsh

先确认当前 Shell：

echo $SHELL

正常情况下应输出：

/bin/zsh

再确认 Homebrew 路径：

brew --prefix

请记住该命令输出的路径。后文配置会通过 brew --prefix 自动获取它，无需手动区分不同的 Homebrew 安装位置。

第一步：配置 iTerm2

打开以下设置页面：

iTerm2 → Settings → Profiles → General

确认：

Command：Login Shell
Load shell integration automatically：开启

然后在屏幕顶部的 View 菜单中建议关闭：

Auto Composer
Auto Command Completion

这两项功能可能接管输入、Tab、方向键或历史候选，与 Zsh 插件的功能重叠。iTerm2 Shell Integration 可以继续保持开启。

修改设置后，请新建 iTerm2 窗口或标签页。已有 Shell 会话不一定会自动加载新的集成功能。

第二步：安装 Zsh 插件和 zoxide

在终端执行：

brew install zsh-autosuggestions zsh-syntax-highlighting zoxide

如果希望使用 zi 打开交互式目录选择器，再安装 fzf：

brew install fzf

这些都是用户级终端工具，不需要安装到具体的 npm、Python 或 .NET 项目中。

第三步：配置 ~/.zshrc

使用 nano 打开 Zsh 配置文件：

nano ~/.zshrc

如果文件不存在，nano 会在保存时创建。将下面的配置加入文件：

# 初始化 Zsh 原生补全系统。
autoload -Uz compinit
compinit

# 多个补全候选使用可选择菜单。
zstyle ':completion:*' menu select

# 补全时忽略英文字母大小写。
zstyle ':completion:*' matcher-list 'm:{a-zA-Z}={A-Za-z}'

# 获取当前 Homebrew 的实际安装路径。
HOMEBREW_PREFIX="$(brew --prefix)"

# 根据历史记录显示灰色命令建议。
source "$HOMEBREW_PREFIX/share/zsh-autosuggestions/zsh-autosuggestions.zsh"

# 启用智能目录跳转，提供 z 和 zi 命令。
eval "$(zoxide init zsh)"

# 启用 Shell 输入语法高亮。
# 语法高亮应放在其他插件和自定义 ZLE 按键配置之后加载。
source "$HOMEBREW_PREFIX/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh"

插件加载顺序为什么重要

zsh-syntax-highlighting 通常应该放在其他插件和自定义 ZLE 按键配置之后加载。这样可以减少按键绑定或高亮行为失效的问题。

zsh-autosuggestions 负责历史命令建议，compinit 负责 Tab 补全，两者功能不同，可以同时使用。

在 nano 中保存配置

1. 按 Control-O 保存。
2. 按回车确认文件名。
3. 按 Control-X 退出。

让配置在当前终端立即生效：

source ~/.zshrc

也可以关闭当前 iTerm2 标签页，再新建一个标签页。

第四步：验证各项功能

验证 Zsh 自动建议

先执行一次完整命令，例如：

git status

在新的提示符中输入：

git

后方应显示灰色的历史命令建议。当光标位于输入末尾时，按右方向键即可接受完整建议。

验证语法高亮

分别输入一个存在和不存在的命令，但不必执行不存在的命令：

ls
this-command-does-not-exist

两者应显示不同颜色。颜色会随 iTerm2 主题变化。

验证 Tab 补全

进入一个包含子目录的位置：

cd ~/Documents

输入 cd 和一个空格，然后按 Tab：

cd <Tab>

再次按 Tab 可进入候选选择状态。使用方向键选择目录，按回车填入，再按回车执行。

验证 zoxide 智能目录跳转

zoxide 需要先学习你访问过的目录。先进入几个常用目录：

cd ~/Documents
cd ~/Downloads
cd ~/Desktop

之后可以按关键词跳转：

z Documents
z Downloads

如果安装了 fzf，可以运行：

zi

随后在交互界面中搜索并选择历史目录。

验证 iTerm2 最近目录

打开：

Session → Open Recent Directories…

快捷键是：

Command-Option-/

iTerm2 会按访问频率和最近访问时间显示目录。双击会输入路径；按住 Option 再双击会输入 cd 命令。

常用快捷键与命令

操作	快捷键或命令
中断当前程序	Control-C
搜索 Zsh 历史	Control-R
召回上一条历史命令	上方向键
接受灰色自动建议	右方向键
文件或目录补全	Tab
清理当前画面	Control-L 或 clear
复制选中文本	Command-C
粘贴	Command-V
跳转到学习过的目录	z 关键词
交互选择历史目录	zi

注意：macOS 中 Command-C 是复制；终止正在运行的命令应使用 Control-C。

常见问题排查

zsh-autosuggestions 的灰色文字看不清

打开：

iTerm2 → Settings → Profiles → Colors

检查背景色与 ANSI Bright Black 是否有足够对比度，也可以更换颜色主题后重新测试。

上方向键没有召回预期命令

继续按上方向键浏览更早记录，或者按 Control-R，再输入命令中的独特片段进行搜索。

如果启用了 iTerm2 Auto Composer，请先关闭，再测试 Zsh 原生历史行为。

zi 无法打开交互选择界面

检查 fzf 是否已安装：

command -v fzf

如果没有输出，执行：

brew install fzf

然后新建 iTerm2 标签页，再运行 zi。

插件加载失败或提示 no such file

先检查 Homebrew 路径：

brew --prefix

本文的配置通过 brew --prefix 自动获取 Homebrew 路径。如果插件仍然无法加载，请先确认 Homebrew 命令可用，并检查插件文件是否存在。

还可以直接检查插件文件是否存在：

ls "$(brew --prefix)/share/zsh-autosuggestions/zsh-autosuggestions.zsh"
ls "$(brew --prefix)/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh"

修改 ~/.zshrc 后没有生效

执行：

source ~/.zshrc

如果仍未生效，检查配置语法：

zsh -n ~/.zshrc

命令没有输出通常表示未发现语法错误。随后关闭当前 iTerm2 标签页并新建一个标签页。

哪些插件不建议同时开启

初次配置时，不建议同时启用以下多套输入接管功能：

• iTerm2 Auto Composer
• iTerm2 Auto Command Completion
• zsh-autocomplete
• zsh-autosuggestions

它们的部分功能重叠，可能同时影响 Tab、方向键、历史召回和候选菜单。推荐让 iTerm2 Shell Integration 负责终端识别，让 Zsh、zsh-autosuggestions、zsh-syntax-highlighting 和 zoxide 负责输入体验。

常见问题 FAQ

zsh-autosuggestions 和 Tab 补全有什么区别？

zsh-autosuggestions 根据历史记录显示整条命令建议；Zsh 的 compinit 则补全命令名称、参数、文件和目录。两者可以同时开启。

zoxide 会替代 cd 命令吗？

不会。cd 仍然可以正常使用。zoxide 只是增加了 z 和 zi，适合快速跳转到经常访问的目录。

Homebrew 安装路径不同怎么办？

不需要手动修改固定路径。本文通过 HOMEBREW_PREFIX="$(brew --prefix)" 获取实际安装位置，再从该目录加载插件。

是否必须安装 Oh My Zsh？

不需要。本文使用 Zsh 原生补全和独立插件，不依赖 Oh My Zsh。如果你已经使用 Oh My Zsh，需要注意不要重复加载相同插件。

完成以上设置后，iTerm2 就具备命令自动建议、语法高亮、Tab 补全和智能目录跳转能力。建议逐项验证，出现问题时优先检查 Homebrew 路径、插件加载顺序和 iTerm2 输入辅助功能是否发生冲突。