Mac OS zsh配置自定义多行PROMPT 按Command+K清屏后仅显示最后一行

核心原因 #

Mac 自带终端的 Command + K 默认逻辑是直接擦除滚动缓冲区、把光标移到屏幕顶部，不会向zsh发送标准清屏的ANSI转义序列，zsh的行编辑模块感知不到屏幕内容已被清空，不会触发完整提示符的重绘流程，仅保留光标所在行的最后一段提示符内容。
另外你当前写的PROMPT本身存在语法拼接错误，zsh的prompt转义括号被换行符拆分到了不同的字符串段中，会进一步导致提示符结构解析异常。

需要补充的配置项 #

在 .zshrc 文件中添加、修改以下内容：

• 开启提示符动态解析开关

  setopt prompt_subst
  

• 重定义内置清屏组件，让清屏完成后强制重绘完整多行提示符

  # 自定义清屏逻辑：发送标准清屏转义序列
  function clear-screen() {
    print -n '\e[2J\e[H'
    # 强制重置并重绘完整提示符
    zle .reset-prompt
    zle -R
  }
  # 将自定义逻辑绑定到zle的内置清屏组件
  zle -N clear-screen clear-screen
  

• 修正原有PROMPT的语法错误
  按照zsh prompt的转义规则，整个条件判断结构必须是连续的转义序列，不能被换行拆分，修正后的正确写法为：

  PROMPT='%(1V.(%1v).)'$'\n''%F{166}%n%f at %F{229}%m%f in %F{114}%.%f'$'\n''$ '
  

  注意：原配置中条件块的闭合括号被拆分到了独立的字符串段，中间夹了换行符，导致zsh解析时出现结构错误，第一行提示符的逻辑完全失效。
• （可选）修正终端按键映射
  如果配置完成后按 Command + K 依然触发的是默认清屏逻辑，可在终端偏好设置的描述文件-键盘配置中，把 Command + K 对应的发送动作修改为发送字符串 \014（即Ctrl+L对应的按键序列），让终端把清屏触发信号正确传递给zsh，而非走默认的缓冲区擦除逻辑。

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