为什么neovim搭配tmux时双击<esc>清除搜索高亮的映射失效？

问题原因 #

• 核心冲突来自Neovim和tmux的按键超时参数不匹配，以及两者对终端逃逸序列的处理逻辑差异：
  1. Neovim默认的键码超时时间（ttimeoutlen）远短于Vim8的默认值：Vim8默认ttimeoutlen跟随timeoutlen（默认1000ms），而Neovim默认将ttimeoutlen设为10ms，用于加快功能键响应速度。如果两次ESC按键的间隔超过这个阈值，Neovim会将其识别为两个独立的ESC按键，而非你配置的组合映射。
  2. tmux本身也存在escape-time配置项，用于判断收到的ESC是用户单独输入的按键，还是终端功能键逃逸序列的开头，默认值通常为300~500ms。tmux的超时判断会叠加在Neovim的超时逻辑上，进一步降低双击ESC映射的识别成功率。
  3. 额外排查项：可在Neovim中执行:verbose map <esc><esc>查看映射是否存在、是否被其他插件覆盖，部分Neovim插件可能默认占用ESC相关的快捷键组合。

解决方案 #

• 调整Neovim的超时参数，在你的Neovim配置文件（通常为~/.config/nvim/init.vim或~/.config/nvim/init.lua）中添加以下配置：

  " vimscript 配置
  set timeoutlen=1000
  set ttimeoutlen=100
  

  以上配置将按键组合识别超时设为1000ms，终端键码识别超时设为100ms，既保留了功能键的响应速度，也预留了足够的双击ESC间隔。
• 调整tmux的超时参数，在~/.tmux.conf中添加以下配置降低tmux侧的逃逸序列等待时间：

  set -sg escape-time 10
  

  修改后执行tmux source ~/.tmux.conf生效即可。

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