如何正确配置zsh自动补全？解决Tab循环与历史搜索异常问题

Tab无法循环补全菜单 #

原因 #

zsh-vi-mode会覆盖Tab键的默认绑定，将其映射为vi模式下的缩进操作，导致zsh-autocomplete依赖的Tab向下循环补全逻辑被覆盖，仅Shift+Tab（反向循环）未受冲突影响。

修复 #

1. 调整插件加载顺序：确保zsh-autocomplete在zsh-vi-mode之后加载，让前者的按键绑定优先级更高。
2. 手动绑定Tab键：在.zshrc末尾添加以下配置：

   bindkey '^I' menu-select-down  # 将Tab绑定为向下循环补全
   bindkey '^[[Z' menu-select-up  # 保留Shift+Tab为向上循环（可选）
   

   若使用iTerm2，可通过终端设置确认Tab键发送的是^I，避免按键编码不匹配。

前缀历史遍历失效 #

原因 #

zsh-history-substring-search的上下键绑定被zsh-vi-mode的模式绑定覆盖，且默认配置下该插件的搜索绑定仅在vi normal模式生效，而你是在insert模式下输入前缀后触发操作，导致无响应。

修复 #

1. 调整插件加载顺序：确保zsh-history-substring-search在zsh-vi-mode之后加载。
2. 为insert模式绑定历史搜索：在.zshrc中添加：

   # 给vi insert模式绑定上下键到历史前缀搜索
   bindkey -M viins '^[[A' history-substring-search-up
   bindkey -M viins '^[[B' history-substring-search-down
   

   若终端上键发送的是^[OA而非^[[A，可通过cat -v命令验证：输入cat -v后按上键，查看输出的控制字符，再替换对应绑定参数。

macOS下bindkey的特殊配置说明 #

macOS终端（Terminal.app/iTerm2）的按键编码可能与Linux终端存在差异：

• 上下箭头：部分终端默认发送^[[A/^[[B，部分则是^[OA/^[OB，需用cat -v确认后再配置bindkey。
• Meta键设置：Terminal.app的“使用Option键作为Meta键”选项会影响^[开头的绑定，需根据自身使用习惯在终端偏好设置中确认开启状态，避免绑定失效。

内容的提问来源于stack exchange，提问作者Sito