macOS默认zsh需手动配置才能实现智能补全：先启用原生补全框架（autoload+compinit），再安装git/zsh-autosuggestions/zsh-syntax-highlighting三插件，最后调整大小写不敏感及自定义命令补全。

MacOS 默认终端用的是 zsh，但原生状态不带智能补全——得手动激活补全框架、装插件、调参数，才能实现命令、参数、分支名甚至历史命令的“一按即出”。核心就三步：启用补全系统、加实用插件、微调体验细节。

启用 zsh 原生补全框架

zsh 的补全能力不是开箱即用的，必须显式初始化。否则 Tab 键只会补文件名，不会补 git 子命令或 docker 参数。

• 编辑配置文件：nano ~/.zshrc
• 在文件末尾添加两行：
  autoload -Uz compinit
compinit
• 保存后运行 source ~/.zshrc 生效

这一步是所有高级补全的前提。没有它，后续插件大多无法触发深度补全逻辑。

装三个关键插件提升实用性

oh-my-zsh 的插件机制让扩展变得简单。推荐这三个组合，覆盖高频痛点：

• git 插件：自动补全 git checkout <Tab> 显示本地分支、git push origin <Tab> 补远程分支名
• zsh-autosuggestions：输入 docker run <Tab>，右侧浮现你上次用过的完整容器启动命令（灰色），按 → 键直接采纳
• zsh-syntax-highlighting：命令输对了变绿色，拼错变红色，路径部分高亮为黄色，肉眼就能判断是否可执行

安装方式统一：先克隆到插件目录，再写进 plugins=() 数组，最后 source ~/.zshrc。例如：

macos-suite-readonly

macOS 只读查询：Mail 未读、Calendar 日程、Notes 搜索、Stocks 行情（输出 JSON）。

下载

plugins=(git zsh-autosuggestions zsh-syntax-highlighting)

让补全不区分大小写

默认 Tab 补全严格区分大小写，比如输入 doc<Tab> 不会匹配 Dockerfile。加上这行就能解决：

• 在 ~/.zshrc 中 compinit 后面追加：
  zstyle ':completion:*' matcher-list 'm:{a-zA-Z}={A-Za-z}'

这样输入 doc<Tab> 就能补全 Dockerfile 或 document.html，更符合直觉。

补充：为特定命令加自定义补全

比如你写了脚本 gmt 用来一键合并 Git 分支，想让它支持 Tab 补本地分支名，可以加一段补全定义：

• 在 ~/.zshrc 底部添加：

_gmt() { _describe 'branch' git_branches }
compdef _gmt gmt

• 再加一行生成分支列表：
  git_branches=(${(f)"$(git branch --format='%(refname:short)')"})

保存后重载配置，gmt <Tab> 就会列出所有本地分支供选择。