如何在zsh小部件中在提示符下方打印带颜色的文本？

方案1：利用终端Terminfo序列直接控制屏幕（推荐） #

通过zsh的terminfo变量获取终端的光标控制、颜色设置序列，在zle小部件中直接操作终端屏幕——先保存光标位置，输出带格式的文本，等待按键后清除内容并恢复界面。这种逻辑和zsh-autocomplete、fzf的底层实现一致，完全满足你的需求。

代码示例 #

# 定义显示命令描述的zle小部件
show_command_desc() {
  # 保存当前光标位置（Terminfo的sc：save cursor）
  print -n -- "$terminfo[sc]"

  # 获取当前提示符的行数，计算下移距离
  local prompt_height=$(print -P "%_" | wc -l)
  # 移动光标到提示符的下一行
  print -n -- "$terminfo[cud]$prompt_height"

  # 输出带颜色和换行的命令描述（用Terminfo序列保证跨终端兼容性）
  print -n -- "$terminfo[setaf1]ls$terminfo[sgr0] - 列出目录下的文件和子目录\n"
  print -n -- "$terminfo[setaf2]cd$terminfo[sgr0] - 切换当前工作目录\n"
  print -n -- "$terminfo[setaf3]grep$terminfo[sgr0] - 在文本中搜索匹配的模式\n"

  # 捕获任意按键（无需回车）
  local pressed_key
  read -k pressed_key

  # 恢复光标位置并清除输出内容
  print -n -- "$terminfo[rc]"          # 回到之前保存的光标位置
  print -n -- "$terminfo[ed]"          # 清除当前位置到屏幕底部的所有内容
  zle reset-prompt                     # 重新绘制提示符，确保界面正常
}

# 注册小部件到zle
zle -N show_command_desc

# 绑定热键（示例：Ctrl+Shift+H，可根据需求修改）
bindkey '^[[1;6H' show_command_desc

方案2：扩展zle消息系统（简化版） #

虽然zle -R默认的消息区域有限，但可以结合多行转义序列实现简单的带格式显示，适合内容较少的场景。

代码示例 #

show_command_desc_simple() {
  # 构造带颜色和换行的消息内容
  local msg=$'\n'"$terminfo[setaf1]ls$terminfo[sgr0] - 列出文件"$'\n'"$terminfo[setaf2]cd$terminfo[sgr0] - 切换目录"
  
  # 用zle -R显示消息，等待按键后清除
  zle -R "$msg"
  local key
  read -k key
  
  # 清除消息并重置提示符
  zle -R ""
  zle reset-prompt
}

zle -N show_command_desc_simple
bindkey '^[[1;6H' show_command_desc_simple

关键注意事项 #

• 优先使用terminfo变量（如$terminfo[setaf1]、$terminfo[sc]）而非硬编码转义序列，确保在xterm、tmux、alacritty等不同终端下的兼容性。
• 必须调用zle reset-prompt，用于重新绘制提示符，避免操作后界面残留异常。
• 热键绑定可灵活修改，使用bindkey -L查看当前绑定，read -k可测试目标按键对应的序列。

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