春节假期到了，有些小伙伴可能跟我一样，家里有台linux服务器，自己使用MacOS笔记本，但是SSH 登录 Linux 服务器时都会遇到这个令人头秃的问题：本地终端一切正常，远程服务器上却各种快捷键失灵。zsh 自动补全不触发，Neovim 的 nvim-cmp 不能选择候选项，Copilot 无法接受建议，Alt 组合键像消失了一样。表面看是"快捷键不一样"，实际上这是一个终端控制序列不一致的问题。
本次就把这个问题解释清楚，系统介绍问题根因以及最稳妥的解决方案。
一、问题现象
环境如下：
服务器：Ubuntu 24.04
Shell：zsh
编辑器：Neovim
插件：自动补全插件 + Copilot
本地系统：macOS
连接方式：macOS 终端 SSH 登录服务器
登录服务器后出现以下问题：
Alt + f 无法向前跳词
Alt + b 无法向后跳词
Neovim 中某些补全触发键失效
zsh 菜单补全异常
本地终端没有报错，但远程环境明显"按键不正常"。
二、问题本质
很多人会误以为这是 zsh 或 Neovim 的配置问题，其实根因在更底层。
终端中的"快捷键"并不是一个抽象概念。终端本质是字节流。当你按下一个组合键时，终端并不是发送"Alt"这个概念，而是发送一串控制字符。
在类 Unix 世界中，Alt 键的实现方式是：
发送 ESC（转义字符）+ 后续字符
例如：
Alt + f 实际发送的是 ESC + f
ESC 的字节值是 0x1b
这是一种从 VT100 时代沿用至今的标准约定。
问题在于，macOS 默认并不会把 Option 键当成 Alt。它会把 Option 当作"特殊字符输入键"。比如：
Option + f 会输入 ƒ
Option + b 会输入 ∫
Linux 并不理解这些符号。zsh 和 Neovim 期望收到的是 ESC 前缀，但实际收到的是特殊字符，自然无法识别。
所以，这不是 SSH 的问题，也不是服务器的问题，而是 macOS 终端发送的控制序列不符合 Linux 的约定。
三、解决思路
解决方案的核心思路非常简单：
让 macOS 的 Option 键真正变成 Linux 世界里的 Alt 键。
推荐使用 iTerm2，因为它对远程开发支持更完善。
四、具体操作步骤
第一步，安装并打开 iTerm2。
第二步，打开设置界面。
点击菜单栏 iTerm2 → Settings，或者使用快捷键 Command + 逗号。
第三步，进入按键配置页。
在设置窗口中选择 Profiles，然后选择当前使用的 Profile（通常是 Default），再点击 Keys 标签页。
在页面中可以看到两个选项：
Left Option Key
Right Option Key
第四步，修改 Option 行为。
将这两个选项都改为：
Esc+
不要选择 Normal，也不要选择 Meta，必须选择 Esc+。
设置完成后关闭设置窗口即可。
五、验证是否生效
重新通过 iTerm2 SSH 登录服务器。
在服务器上执行：
cat
然后按下：
Option + f
如果配置正确，终端会显示：
^[f
其中 ^[ 表示 ESC。
如果看到的是 ƒ 之类的特殊字符，说明设置还未生效。
验证通过后，再测试：
Alt + f 是否可以向前跳一个单词
Alt + b 是否可以向后跳一个单词
通常 zsh 补全和 Neovim 插件会立即恢复正常。
六、为什么这一步如此关键
在 Linux 生态中，Alt 键几乎是基础编辑能力的一部分：
Alt + f / b 用于单词跳转
Alt + . 插入上一条命令的最后一个参数
许多 zsh 菜单补全功能依赖 Alt
Neovim 插件大量使用 Alt 作为映射键
如果 Option 不发送 ESC 前缀，远端环境永远无法正确识别这些组合键。
这一步的本质，是让终端的控制序列与 Linux 约定保持一致。
最后，祝福春节假期还要带笔记本回家的牛马们，马年快乐。