zsh-autosuggestions

名称、版本与用途

  • 名称:zsh-autosuggestions
  • 当前版本:Git commit 85919cd1ffa7
  • 目录:~/.oh-my-zsh/custom/plugins/zsh-autosuggestions
  • 用途:根据历史记录和补全结果,在输入时显示可接受的灰色建议。

当前安装与更新

当前是 Git 克隆,origin 为 https://github.com/zsh-users/zsh-autosuggestions。

git -C ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions pull --ff-only

更新后执行 exec zsh。

配置文件

插件本身位于 Oh My Zsh 自定义插件目录;可在 .zshrc 中设置:

ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE='fg=8'
ZSH_AUTOSUGGEST_STRATEGY=(history completion)

当前未设置额外的 autosuggestions 变量,使用默认行为。

zsh 启动集成

是,列在 .zshrc 的 plugins=(...) 中,由 Oh My Zsh 启动时加载。

基本功能与推荐用法

  • 输入命令时使用右方向键或 End 接受建议。
  • 使用 Ctrl+F 接受建议,可按需添加绑定:
bindkey '^F' autosuggest-accept

常用检查:

type _zsh_autosuggest_start
bindkey | rg autosuggest

推荐保持历史文件可用,并避免把包含敏感信息的命令写入历史。策略越多,建议越丰富,但启动和交互成本也会增加。

示例中的选项、参数与子命令

本表解释本页示例实际出现的选项、参数、子命令及必要的辅助命令语法。

语法元素含义
git -C DIR在 DIR 中运行 Git,无需先 cd。
git pull --ff-only只允许快进更新,避免自动产生合并提交。
ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE设置建议文本的高亮样式。
ZSH_AUTOSUGGEST_STRATEGY设置生成建议时使用的策略。
bindkey KEY WIDGET把按键序列绑定到指定 zsh widget。
type NAME确认函数、命令或 widget 的解析结果。

官方资料