macOS Monterey tmux+zsh下clear命令失效如何解决

执行clear命令时返回如下错误，且该问题仅在macOS Monterey 12.4 系统的tmux+zsh环境下触发，原生终端、bash环境下均无异常：

» clear
terminals database is inaccessible

最快生效的方案是在~/.zshrc文件末尾追加一行环境变量配置，指定系统原生terminfo路径：

export TERMINFO=/usr/share/terminfo

保存后执行source ~/.zshrc重载zsh配置，重启tmux会话后执行clear即可正常运行，不会影响终端颜色、快捷键等其他功能。

macOS Monterey 12.4 调整了系统terminfo（终端能力数据库）的默认查找优先级，通过Homebrew安装的tmux启动时会优先读取Homebrew路径下的terminfo目录，但该目录默认未内置tmux-256color/screen-256color这类tmux默认使用的终端类型配置，导致clear等依赖terminfo的命令无法读取终端参数触发报错。
该问题仅在tmux+zsh组合环境下出现：

• 原生终端（Terminal.app/iTerm2）启动时会自动注入正确的TERMINFO路径，不会触发路径查找问题
• bash环境默认会加载系统级环境变量配置补全TERMINFO路径，不会出现该报错
• zsh默认不会主动补全该路径配置，因此tmux嵌套会话下会触发数据库找不到的错误

如果快速修复方案不生效，可按实际场景选择以下方案：

• 方案1：手动补全tmux对应terminfo条目
  进入tmux会话后执行以下命令，手动编译安装tmux对应的终端能力配置：

  infocmp tmux-256color > /tmp/tmux-256color.info
  tic -x /tmp/tmux-256color.info
  

  执行完成后重启tmux即可。
• 方案2：使用不依赖terminfo的清屏别名
  如果不需要依赖terminfo的其他高级终端特性，可以直接在~/.zshrc中追加别名，用终端原生控制序列实现清屏：

  alias clear='printf "\033c"'
  

  重载配置后所有场景下的clear命令都会直接触发终端硬清屏，完全不依赖terminfo数据库。

避坑提示：不要直接将tmux的default-terminal配置修改为xterm-256color，该操作会导致tmux内功能键映射、24位色显示、终端尺寸自适应等功能出现异常。

内容的提问来源于stack exchange，提问作者NP Rooski Z