macOS 的 zsh 默认 Tab 补全区分大小写，需配置 compinit 和 zstyle 实现大小写不敏感匹配；进阶可添加模糊路径匹配规则提升补全灵活性。
macos 的 zsh 默认 tab 补全严格区分大小写，比如输入 docu<tab> 无法匹配 dockerfile 或 documents。要让它“看一眼就懂”，关键不是改 .inputrc（对 zsh 基本无效），而是正确配置 zsh 自带的补全系统，并启用模糊匹配策略。
启用 zsh 补全框架是前提
没有这一步，所有高级补全都不可用。zsh 的智能补全不是默认开启的，必须显式加载。
- 编辑
~/.zshrc：运行nano ~/.zshrc - 在文件末尾添加两行（如果已有
compinit就不用重复）：autoload -Uz compinitcompinit - 保存后执行
source ~/.zshrc生效
添加大小写不敏感的核心规则
仅靠 compinit 还不够，需告诉补全系统“忽略大小写”。这通过 zstyle 指令实现，放在 compinit 后面即可。
- 在
~/.zshrc中compinit下方添加：zstyle ':completion:*' matcher-list 'm:{a-zA-Z}={A-Za-z}' - 这行的意思是：把输入中的小写字母 a–z 映射成大写 A–Z，大写字母 A–Z 映射成小写 a–z，实现双向等价匹配
- 保存并
source ~/.zshrc，现在cd docu<Tab>就能补全Documents、docker-compose.yml等了
进阶：加入模糊路径匹配（可选但推荐）
如果还想让 docum<Tab> 匹配 Documents（缺字母）、doc-ment<Tab> 匹配 document.md（含分隔符），可以增强 matcher-list：
- 替换或追加这一行：
zstyle ':completion:*' matcher-list 'm:{a-zA-Z}={A-Za-z}' 'r:|[._-]=* r:|=*' 'l:|=* r:|=*' - 其中
r:|[._-]=*表示允许把.、_、-当作通配符跳过；l:|=*和r:|=*支持前/后缀通配 - 注意：过度模糊可能降低准确性，日常建议先用基础大小写忽略，再按需叠加
验证是否生效的小技巧
别只试 cd，多场景验证更可靠：
-
git chec<Tab>→ 应补全checkout、check-ref-format -
ls ~/docu<Tab>→ 应列出大小写混合的目录名 -
open doc<Tab>→ 应匹配桌面或文档里的各种命名变体 - 如果某命令仍不响应，可能是它没注册补全函数，可临时运行
_command_names | grep xxx查看支持情况
