在tmux中使用Neovim时<Ctrl-`>等按键映射失效求助

核心原因：tmux的按键拦截与转译问题 #

• tmux默认会拦截部分Ctrl组合键，其中Ctrl-=和Ctrl-（反引号）属于tmux可能捕获的按键，导致这些按键没有正确传递给Neovim，反而触发了tmux自身的命令或者错误的Vim内置操作，才会出现E20: mark not set和E21: cannot make changes这类与映射无关的错误。
• 另外，macOS的iTerm2在处理特殊组合键时，可能存在转译差异，加上tmux的按键处理层，进一步导致按键信号传递异常。

具体解决步骤 #

1. 让tmux放行目标按键 #

在你的~/.tmux.conf中添加以下配置，告诉tmux不要拦截这两组按键，直接传递给下层的Neovim：

# 放行Ctrl-`和Ctrl-=给Neovim
bind-key -n C-` send-keys C-`
bind-key -n C-= send-keys C-=

添加后，执行tmux source ~/.tmux.conf重载配置。

2. 确认iTerm2的按键映射设置 #

打开iTerm2的偏好设置 -> 按键，检查是否有将Ctrl-或Ctrl-=映射为其他功能的配置，如果有，直接删除或者设置为Send Hex Code对应的值：

• Ctrl-对应的十六进制代码是0x60 0x10
• Ctrl-=对应的十六进制代码是0x3d 0x10
  确保这些按键没有被iTerm2提前拦截修改。

3. 验证Neovim映射的正确性 #

确认你的Neovim按键映射没有语法问题，比如映射是否在正确的模式下设置（普通模式nmap或者nnoremap），示例配置如下：

-- 示例：telescope的Ctrl-`和Ctrl-=映射
vim.keymap.set('n', '<C-`>', '<cmd>Telescope some_command<CR>', { noremap = true, silent = true })
vim.keymap.set('n', '<C-=>', '<cmd>Telescope another_command<CR>', { noremap = true, silent = true })

确保noremap设置为true，避免递归映射导致的异常。

补充说明 #

如果上述步骤后仍有问题，可以尝试在tmux中开启xterm-keys支持，在~/.tmux.conf中添加：

set-option -g xterm-keys on

这会让tmux更好地处理终端发送的特殊按键序列。

内容的提问来源于stack exchange，提问作者김상현