zsh-syntax-highlighting

名称、版本与用途

  • 名称:zsh-syntax-highlighting
  • 当前版本:Git commit 5eb677bb0fa9
  • 目录:~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting
  • 用途:在命令执行前按语法、命令有效性、路径和引号状态着色。

当前安装与更新

当前是 Git 克隆:

git -C ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting pull --ff-only
exec zsh

配置文件

配置通常写在 .zshrc,并且应在插件加载前设置。例如:

ZSH_HIGHLIGHT_HIGHLIGHTERS=(main brackets pattern)
ZSH_HIGHLIGHT_STYLES[unknown-token]='fg=red'

当前使用默认高亮器和样式。

zsh 启动集成

是,当前列在 plugins=(...) 的最后。高亮插件通常应在其他补全和输入组件之后加载,以便正确包装 ZLE widget。

基本功能与推荐用法

type _zsh_highlight
print -l $ZSH_HIGHLIGHT_HIGHLIGHTERS
print -l ${(kv)ZSH_HIGHLIGHT_STYLES} | head

推荐:

  • 命令显示为无效时,先用 whence -a <命令> 检查 PATH。
  • 自定义颜色要兼顾当前终端主题和对比度。
  • 出现输入延迟时,先减少附加 highlighter,再检查插件加载顺序。

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

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

语法元素含义
git -C DIR在 DIR 中运行 Git,无需先 cd。
git pull --ff-only只允许快进更新,避免自动产生合并提交。
ZSH_HIGHLIGHT_HIGHLIGHTERS指定启用的 highlighter 及其顺序。
ZSH_HIGHLIGHT_STYLES[KEY]设置指定语法类别的高亮样式。
print -lzsh 内建 print:每个参数输出一行。
${(kv)ARRAY}zsh 参数展开标志:把关联数组展开为键和值。
type NAME确认函数或命令的解析结果。

官方资料