tmux 指南
概念图
上面的概念图概览了tmux的核心构成元素：会话(Session)、窗口(Window)、窗格(Pane)以及配置选项。
1. 基本概念
1.1 会话 (Session)
会话是tmux的最高级别组织单位，一个会话可以包含多个窗口。会话允许你在同一个终端中运行多个任务并轻松切换。
- 创建会话：
tmux new -s <session-name> - 列出会话：
tmux ls - 附着到会话：
tmux attach -t <session-name> - 退出会话（detach，分离但保持会话活跃）：在 tmux 中按
Ctrl-b d— 这是离开 tmux 但保持会话后台运行的标准方式。 - 删除会话（完全终止）：
tmux kill-session -t <session-name>或在 tmux 中运行exit关闭所有窗口。
说明： Ctrl-b d 和 exit 的区别很重要：
Ctrl-b d（detach）：断开连接，会话在后台继续运行，可随时重新附着exit：关闭当前窗口，若所有窗口都关闭，整个会话被删除
1.2 窗口 (Window)
窗口类似于虚拟终端，可以在会话中创建多个窗口，每个窗口有一个编号和名称。
- 创建新窗口：
Ctrl-b c - 切换窗口：
Ctrl-b n(下一个)、Ctrl-b p(前一个)、Ctrl-b <数字> - 查看所有窗口（选择窗口列表）：
Ctrl-b w - 重命名窗口：
Ctrl-b ,然后输入新名称（也可以在配置中绑定快捷键，例如prefix+r）
1.3 窗格 (Pane)
窗格是窗口内的子区域，允许在同一窗口中并排运行多个终端。
- 水平分割：
Ctrl-b " - 垂直分割：
Ctrl-b % - 切换窗格：
Ctrl-b o - 调整大小：
Ctrl-b :resize-pane -L/-R/-U/-D <number> - 关闭窗格：
Ctrl-b x - 显示当前窗口所有 pane 的编号：
Ctrl-b q(会在每个 pane 角落短暂出现数字，可直接按数字切换)
1.4 安装与首次使用
在 Debian/Ubuntu 上安装 tmux：
sudo apt update
sudo apt install tmux验证安装：
tmux -V会输出当前安装的 tmux 版本，例如 tmux 3.3a。
首次使用：
tmux # 创建一个新的会话并进入这会自动创建一个会话（通常名称为 0）。按 Ctrl-b ? 可查看所有快捷键绑定。
创建初始配置文件（可选）：
如果想立即使用自定义配置，可将配置保存到 ~/.tmux.conf，然后重启 tmux 或在 tmux 中运行 tmux source-file ~/.tmux.conf 使配置生效。
1.5 获取帮助
在 tmux 中可以随时查看帮助和快捷键列表：
查看所有快捷键绑定：按
Ctrl-b ?（即prefix + ?）会弹出快捷键列表窗口，可用方向键或 j/k 上下翻页，按 q 退出。查看命令帮助：在命令模式中输入
list-keys可列出所有键绑定，或list-commands列出所有 tmux 命令。查看手册：在终端中运行
man tmux查看完整的 tmux 手册页面（包含所有命令和选项的详细说明）。
2. 进阶使用
2.1 命令模式
按下 Ctrl-b : 可以进入命令模式，直接输入tmux命令，例如 new-window、split-window 等。
2.2 配置文件
默认配置文件位于 ~/.tmux.conf，可以自定义键绑定、选项等。
示例配置：
# -----------------------------------------------------------------------------
# Tmux 基本配置 - 要求 Tmux >= 2.3
# 如果不想使用插件，只需要将此节的内容写入 ~/.tmux.conf 即可
# -----------------------------------------------------------------------------
# C-b 和 VIM 冲突，修改 Prefix 组合键为 Control-Z，按键距离近
set -g prefix C-z
set -g base-index 1 # 窗口编号从 1 开始计数
set -g display-panes-time 10000 # PREFIX-Q 显示编号的驻留时长，单位 ms
set -g mouse on # 开启鼠标, 鼠标滚动的时候会自动进入 copy-mode（复制模式）
set -g pane-base-index 1 # 窗格编号从 1 开始计数
set -g renumber-windows on # 关掉某个窗口后，编号重排
setw -g allow-rename off # 禁止活动进程修改窗口名
setw -g automatic-rename off # 禁止自动命名新窗口
setw -g mode-keys vi # 进入复制模式的时候使用 vi 键位（默认是 EMACS）
# window management 窗口管理
bind -n M-o new-window -c "#{pane_current_path}" # Alt+o：在当前窗格路径下创建一个新窗口
bind -n M-O break-pane # Alt+Shift+o：将当前窗格拆分为一个新窗口（break-pane）
bind -n M-Q kill-pane # Alt+Shift+q：关闭当前窗格
# 快捷重命名
bind r command-prompt -I "#W" "rename-window '%%'" # prefix+r：重命名当前窗口
# window navigation 窗口导航
unbind n # 取消默认的“n”键绑定（下一个窗口）
unbind p # 取消默认的“p”键绑定（上一个窗口）
unbind 1 # 取消默认的“1”键绑定（选择窗口1）
unbind 2 # 取消默认的“2”键绑定（选择窗口2）
unbind 3 # 取消默认的“3”键绑定（选择窗口3）
unbind 4 # 取消默认的“4”键绑定（选择窗口4）
unbind 5 # 取消默认的“5”键绑定（选择窗口5）
unbind 6 # 取消默认的“6”键绑定（选择窗口6）
unbind 7 # 取消默认的“7”键绑定（选择窗口7）
unbind 8 # 取消默认的“8”键绑定（选择窗口8）
unbind 9 # 取消默认的“9”键绑定（选择窗口9）
unbind 0 # 取消默认的“0”键绑定（选择窗口10）
bind -r C-p previous-window # Ctrl+p：切换到上一个窗口（可重复）
bind -r C-n next-window # Ctrl+n：切换到下一个窗口（可重复）
bind -n M-1 select-window -t 1 # Alt+1：选择窗口1
bind -n M-2 select-window -t 2 # Alt+2：选择窗口2
bind -n M-3 select-window -t 3 # Alt+3：选择窗口3
bind -n M-4 select-window -t 4 # Alt+4：选择窗口4
bind -n M-5 select-window -t 5 # Alt+5：选择窗口5
bind -n M-6 select-window -t 6 # Alt+6：选择窗口6
bind -n M-7 select-window -t 7 # Alt+7：选择窗口7
bind -n M-8 select-window -t 8 # Alt+8：选择窗口8
bind -n M-9 select-window -t 9 # Alt+9：选择窗口9
# 将新的窗格加入到指定窗口（join-pane）
bind -n M-! join-pane -t :1 # Alt+!：将当前窗格加入到窗口1
bind -n M-@ join-pane -t :2 # Alt+@：将当前窗格加入到窗口2
bind -n 'M-#' join-pane -t :3 # Alt+#：将当前窗格加入到窗口3
bind -n 'M-$' join-pane -t :4 # Alt+$：将当前窗格加入到窗口4
bind -n M-% join-pane -t :5 # Alt+%：将当前窗格加入到窗口5
bind -n M-^ join-pane -t :6 # Alt+^：将当前窗格加入到窗口6
bind -n M-& join-pane -t :7 # Alt+&：将当前窗格加入到窗口7
bind -n M-* join-pane -t :8 # Alt+*：将当前窗格加入到窗口8
bind -n M-( join-pane -t :9 # Alt+(：将当前窗格加入到窗口9
bind j split-window -vb -c "#{pane_current_path}" # u：向下分屏
bind k split-window -v -c "#{pane_current_path}" # e：向上分屏
bind h split-window -hb -c "#{pane_current_path}" # n：向左分屏
bind l split-window -h -c "#{pane_current_path}" # i：向右分屏
bind -n M-f resize-pane -Z # Alt+f：最大化/恢复窗格
bind 1 select-pane -t:.1 # 选择窗格 1
bind 2 select-pane -t:.2
bind 3 select-pane -t:.3
bind 4 select-pane -t:.4
bind 5 select-pane -t:.5
bind 6 select-pane -t:.6
bind 7 select-pane -t:.7
bind 8 select-pane -t:.8
bind 9 select-pane -t:.9
bind 0 select-pane -t:.10 # 选择窗格 10
bind -n M-h select-pane -L # Alt+h：焦点左移
bind -n M-j select-pane -D # Alt+j：焦点下移
bind -n M-k select-pane -U # Alt+k：焦点上移
bind -n M-l select-pane -R # Alt+l：焦点右移
# -----------------------------------------------------------------------------
# 使用插件 - via tpm
# 1. 执行 git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
# 2. 执行 bash ~/.tmux/plugins/tpm/bin/install_plugins
# -----------------------------------------------------------------------------
setenv -g TMUX_PLUGIN_MANAGER_PATH '~/.tmux/plugins'
# 推荐的插件（请去每个插件的仓库下读一读使用教程）
set -g @plugin 'seebi/tmux-colors-solarized'
set -g @plugin 'tmux-plugins/tmux-pain-control'
set -g @plugin 'tmux-plugins/tmux-prefix-highlight'
set -g @plugin 'tmux-plugins/tmux-resurrect'
set -g @plugin 'tmux-plugins/tmux-sensible'
set -g @plugin 'tmux-plugins/tmux-yank'
set -g @plugin 'tmux-plugins/tpm'
# tmux-resurrect
set -g @resurrect-dir '~/.tmux/resurrect'
# tmux-prefix-highlight
set -g status-right '#{prefix_highlight} #H | %a %Y-%m-%d %H:%M'
set -g @prefix_highlight_show_copy_mode 'on'
set -g @prefix_highlight_copy_mode_attr 'fg=white,bg=blue'
# 初始化 TPM 插件管理器 (放在配置文件的最后)
run '~/.tmux/plugins/tpm/tpm'
# -----------------------------------------------------------------------------
# 结束
# -----------------------------------------------------------------------------重新加载配置
tmux source-file ~/.tmux.conf2.3 插件管理 (Plugin Management)
tmux 用插件管理器 tpm (Tmux Plugin Manager) 来安装和管理竟件，推荐使用。
安装 tpm：
git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm在 ~/.tmux.conf 中配置插件：
在文件顶部声明插件目录（可选，默认为
~/.tmux/plugins）：confsetenv -g TMUX_PLUGIN_MANAGER_PATH '~/.tmux/plugins'在文件中间添加想要的插件（使用
set -g @plugin语法）：confset -g @plugin 'tmux-plugins/tmux-sensible' # 合理的默认配置 set -g @plugin 'tmux-plugins/tmux-yank' # 复制到系统剪贴板 set -g @plugin 'tmux-plugins/tmux-resurrect' # 保存/恢复会话 set -g @plugin 'tmux-plugins/tpm' # tpm 本身（必须）在文件末尾初始化 tpm（必须放在最后）：
confrun '~/.tmux/plugins/tpm/tpm'
安装插件：
保存配置文件后，在 tmux 中按 Ctrl-b I（大写 i）即可自动下载并安装所有列出的插件。
常用快捷键（tpm 默认绑定）：
prefix + I：安装新插件prefix + U：更新插件prefix + alt + u：卸载未在配置中列出的插件
常用插件详解：
tmux-plugins/tmux-sensible：提供一套合理的 tmux 默认配置，包括更优的键绑定、更好的窗口和窗格命名策略等，是入门推荐的基础插件。tmux-plugins/tmux-yank：简化复制到系统剪贴板的操作，自动检测平台（X11/Wayland/macOS）并使用对应的剪贴板程序。在复制模式中按y即可复制到系统剪贴板，无需手动配置copy-pipe。tmux-plugins/tmux-resurrect：自动保存当前 tmux 会话的所有窗口、窗格和运行的程序，当 tmux 关闭或重启后可恢复到之前的状态。快捷键：prefix + Ctrl-s保存，prefix + Ctrl-r恢复。tmux-plugins/tmux-pain-control：提供更符合直觉的窗格导航和管理快捷键，例如用方向键移动窗格焦点、用更易记忆的绑定来调整窗格大小。tmux-plugins/tmux-prefix-highlight：在状态栏显示前缀键（prefix）的状态，当按下 prefix 后会高亮显示，方便确认是否处于命令准备状态。seebi/tmux-colors-solarized：应用 Solarized 配色主题到 tmux，提供更舒适的配色方案。使用此插件后可删除手动的颜色配置。tmux-plugins/tpm：tmux 插件管理器本身，必须在插件列表中声明以确保 tpm 自身被正确初始化和更新。
2.4 选项
常用选项包括：
set -g mouse on：启用鼠标操作setw -g mode-keys vi：使用 vi 键绑定进行复制模式
2.5 复制模式 (Copy Mode)
什么是复制模式
复制模式是操作 tmux 自己的历史缓冲区（scrollback buffer），而不是终端的滚动条。进入后，你可以像在 Vim 中编辑一样浏览和选择历史输出。
进入复制模式
按下 Ctrl-b [（即 prefix + [）进入复制模式。你会在左下角看到 [copy mode] 提示。
如果启用了鼠标（set -g mouse on），滚动时也会自动进入复制模式。
强烈建议：启用 Vim 键位
在 ~/.tmux.conf 中添加：
set -g mode-keys vi然后重新加载配置：
tmux source-file ~/.tmux.conf这样可以使用熟悉的 Vim 风格快捷键，否则默认为 Emacs 风格。
复制模式键位表（Vim 风格）
| 功能 | 按键 |
|---|---|
| 上下移动 | j / k |
| 左右移动 | h / l |
| 行首 | 0 |
| 行尾 | $ |
| 上翻页 | Ctrl-b |
| 下翻页 | Ctrl-f |
| 半页上翻 | Ctrl-u |
| 半页下翻 | Ctrl-d |
| 向下搜索 | / |
| 向上搜索 | ? |
| 下一个匹配 | n |
| 上一个匹配 | N |
| 文件首 | gg |
| 文件末 | G |
| 退出复制模式 | q 或 Esc |
选择与复制的标准流程
- 按
Ctrl-b [进入复制模式 - 按
Space开始选择 - 用
hjkl或其他导航键移动选中区域 - 按
Enter将内容复制到 tmux 缓冲区 - 按
Ctrl-b ]粘贴复制的内容
粘贴缓冲内容
在普通模式下按 Ctrl-b ]（prefix + ]）粘贴最近复制的缓冲内容：
Ctrl + b ]或使用命令：
tmux paste-buffer扩大历史缓存（日志分析推荐）
如果你经常处理较长的日志或输出，建议扩大 tmux 的历史缓存限制。在 ~/.tmux.conf 中添加：
set -g history-limit 200000默认值较小，容易被截断。
复制到系统剪贴板（进阶）
推荐使用 copy-pipe-and-cancel 或 tmux-yank 插件来把 tmux 缓冲发送到系统剪贴板。
方式一：手动配置键绑定
对于 Linux + xclip：
sudo apt install xclip然后在 ~/.tmux.conf 中添加：
bind-key -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "xclip -selection clipboard -in"这样在复制模式中按 y 即可直接复制到系统剪贴板。
对于 Wayland (wl-clipboard)：
bind-key -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "wl-copy"方式二：使用插件
推荐使用 tmux-plugins/tmux-yank 插件，它会自动检测平台（X11/Wayland/macOS）并使用对应的剪贴板程序。
实用工作流示例
场景：分析日志中的错误
Ctrl+b [ # 进入复制模式
/ ERROR # 搜索 ERROR
n # 跳转到下一个匹配
Space # 开始选择错误行
hjkl # 调整选择范围
Enter # 复制到 tmux 缓冲
q # 退出复制模式
Ctrl+b ] # 粘贴到当前位置或应用中理解复制模式的原理
程序输出 → pty → tmux scrollback buffer
↓
copy-mode (只读编辑器)关键点：
- 复制模式不影响程序运行
- 只是读取历史缓存
- 可以看作是 Vim 在终端历史记录上的"只读编辑器"
2.6 会话共享
多个用户可以附加到同一个会话，适用于协作。
- 设置权限：登录同一用户或者使用
tmux -S /tmp/socket创建共享socket
2.7 快速脚本
编写脚本自动化tmux布局，例如：
#!/usr/bin/env bash
SESSION="dev"
tmux new-session -d -s "$SESSION"
tmux rename-window -t "$SESSION:0" 'editor'
tmux split-window -h -t "$SESSION:0"
tmux select-pane -t "$SESSION:0.0"
tmux attach -t "$SESSION"3. 常见问题与技巧
- 如何不删除会话地退出 tmux？ 按
Ctrl-b d进行 detach 操作，会话将在后台继续运行。之后可用tmux ls列出所有会话，用tmux attach -t <session-name>重新附着。 - 如何恢复已关闭的窗格？ tmux 不支持直接恢复；建议使用
tmux-resurrect插件。 - 如何调整前缀键？ 在
~/.tmux.conf中使用set -g prefix <key>。
4. 参考资料
说明：本指南从概念图开始，逐步深入到基本操作、高级配置和常见问题，适合初学者和有经验的用户。