Linux Tmux分屏与同步输入教程

首先介绍 tmux 的分屏操作和同步输入功能。这两个功能在日常使用中非常实用，但操作中存在几个容易出错的细节，尤其对于新手而言。

tmux 分屏操作：% 和 " 键的正确用法与常见错误

垂直分屏（左右）使用 %，水平分屏（上下）使用 "（英文双引号）。常见误区在于：不是单引号、不是中文引号、也不是 Shift+' 打出的符号。新手容易卡在此处，往往是输入法未切换为英文模式，或 Caps Lock 开启导致 " 未能正确输出。标准操作流程为：按下 Ctrl+b 后松手，再单独按 "，务必先松手再按，不可连续按下。

分屏之后，焦点默认仍留在原先的 pane 中。切换到新 pane 可使用方向键（↑↓←→），无需鼠标——除非已提前启用鼠标支持。

• 确认当前前缀键：默认是 Ctrl+b，但许多用户已改为 Ctrl+a。操作前请先确认当前使用的前缀键。
• 关闭 pane 时避免误操作：先按 x，再按 y 确认才能关闭，否则仅弹出提示，不会实际执行。
• 临时将所有 pane 合并回单个：按 Ctrl+b 再按 !（英文感叹号）。

开启同步输入：setw synchronize-panes on

同步功能仅对当前 window 生效，不影响其他 window，也不能跨会话使用。在命令行输入 setw synchronize-panes on 即可生效，所有 pane 的键盘输入将实时镜像。

关闭同步需要手动输入命令，而非再次按某个快捷键。需执行 setw synchronize-panes off，或提前在配置文件绑定快捷键。

• 进入命令模式：按 Ctrl+b 后松开，再按 :（英文冒号）。
• 输入完整命令：setw synchronize-panes on，然后回车。关闭时输入 off。
• 同步期间，Ctrl+c 会同时发送给所有 pane，便于批量 kill 进程，但也容易误杀。
• 若某个 pane 正在 vim 中编辑，同步后光标位置不会自动对齐，可能导致混乱。

永久启用同步和鼠标：修改 ~/.tmux.conf

每次手动开启同步效率较低，直接写入配置文件是最稳妥的方案。注意：修改后若不重新加载（reload）不会生效，且 reload 前需确保 ~/.tmux.conf 文件存在且语法正确。

推荐一个最小可用配置，仅两行：

set -g mouse onset -g synchronize-panes on

然后重载：Ctrl+b → : → 输入 source-file ~/.tmux.conf，回车。

• 启用 mouse on 后，可通过鼠标点选 pane、拖拽调整大小、滚动滚轮查看历史记录，操作效率高于仅用方向键。
• synchronize-panes 默认值为 off，需手动设为 on 才能全局生效，并非默认开启。
• reload 时报错通常由引号不匹配或缺失空格引起。可在 shell 中直接运行 tmux source-file ~/.tmux.conf 进行调试，便于定位问题。

同步功能的边界与常见陷阱

同步并非万能：它仅转发按键事件，不保证输出完全一致。例如，一个 pane 中运行 ssh，另一个运行 vim，同步输入后 ssh 可能断连，vim 也可能进入错误模式。

需要特别留意退出行为——Ctrl+d 或 exit 会在所有 pane 同时触发。若某个 pane 恰好是 ssh 连接，整个会话可能意外退出。

• 同步仅作用于当前 window，新开的 window 不会继承该设置，需单独开启。
• 复制粘贴不受同步影响，每个 pane 的剪贴板保持独立。
• 若终端尺寸不一致（如某个 pane 被拉窄），长命令可能出现换行错位，看起来像“未同步”。
• 使用 tmux + zsh + fzf 等带交互菜单的工具时，同步会导致菜单弹出位置混乱，建议临时关闭同步功能。