tmux guide keymaps

Tmux 快捷键与会话恢复

当前 Prefix 已从默认的 Ctrl-b 改为 Ctrl-Space。下文中的 Prefix 均表示先按 Ctrl-Space

窗口和 pane 的高频操作大多不需要 Prefix，以便 Kitty、WezTerm 和 Ghostty 共用同一套快捷键

基础行为

• window 和 pane 从 1 开始编号，窗口关闭后自动重新编号
• 鼠标已启用，复制模式使用 vi 键位
• 新建 window 和 pane 会继承当前 pane 的工作目录
• Prefix r 重新加载完整 Tmux 配置
• 状态栏位于顶部

Window

快捷键	功能
Ctrl-Shift-t	新建 window
Ctrl-Shift-w	关闭当前 window
Ctrl-1～Ctrl-8	切换到对应 window
Prefix R	重命名当前 window

window 默认按当前路径的最后一层目录自动命名

Pane

快捷键	功能
Ctrl-Alt-\	左右分屏，在右侧创建 pane
Ctrl-Alt--	上下分屏，在下方创建 pane
Ctrl-Alt-w	关闭当前 pane
Ctrl-Alt-h/j/k/l	切换 pane
Ctrl-Alt-方向键	每次 3 格调整 pane 大小
Ctrl-Alt-b	当前 pane 全屏或恢复

前台程序是 Neovim 时，方向和调整键会透传给 smart-splits，让 Neovim 分屏与 Tmux pane 使用同一套导航

右键在 Neovim 或鼠标程序中会原样透传；其他情况下从系统剪贴板粘贴。按住 Ctrl 点击 URL 会调用跨平台脚本打开链接

Copy mode

快捷键	功能
Prefix v	进入 vi copy mode
v	开始字符选择
Ctrl-v	开始矩形选择
y	复制并保留在 copy mode
Enter	复制并退出 copy mode
Y	复制整行
[ / ]	跳到上一条或下一条 Starship prompt
Ctrl-y / Ctrl-e	向上或向下滚动 5 行
Ctrl-Alt-h/j/k/l	在 copy mode 中切换 pane

[、] 依赖当前 Starship prompt 使用的特定图标；更换 prompt 后需要同步修改匹配字符

插件管理与恢复

TPM

快捷键	功能
Prefix I	安装配置中的插件
Prefix U	更新插件
Prefix Alt-u	删除已不在配置中的插件

Resurrect 与 Continuum

快捷键	功能
Prefix Ctrl-s	手动保存 Tmux 环境
Prefix Ctrl-r	恢复最近保存的环境

Continuum 每 15 分钟自动保存，并在 Tmux 启动时自动恢复。Resurrect 会保存 pane 输出，并使用 Neovim session 策略恢复编辑器；Claude、Codex 和 OpenCode 会转换为各自的继续/恢复命令

这只能恢复窗口、pane、工作目录和可重启的命令，不等同于恢复任意进程的内存与完整交互现场

注意区分：

• Prefix r：重新加载配置
• Prefix Ctrl-r：恢复 Resurrect 快照

状态栏

• 左侧：session 名和压缩后的当前路径
• 中间：window 编号、名称和 zoom 状态
• 右侧：CPU、RAM 和网络速度
• 上下行速度只有超过约 30KB/s 时才显示
• conf/matugen-colors.conf 存在时覆盖默认颜色

当前 hide-bar.conf 没有被主入口加载，因此进入 Neovim 时不会自动隐藏状态栏

配置位置

主入口是 ~/.config/tmux/tmux.conf，按功能加载 conf/options.conf、copy-mode.conf、pane.conf、window.conf、plugins.conf 和 status.conf