tmux 终端复用器实战指南:命令速查、前缀快捷键与 ~/.tmux.conf 深度配置(learnxinyminutes-docs)

原创2026-10-09 23:58:491,708 阅读
文章标签:文档教程

tmux 终端复用器实战指南:命令速查、前缀快捷键与 ~/.tmux.conf 深度配置(learnxinyminutes-docs)

tmux 是一款终端复用器(terminal multiplexer),它允许你在同一个屏幕下创建、访问和控制多个终端会话,并且可以随时从屏幕"分离"(detach)会话,让程序在后台继续运行,之后再次"重新接入"(attach)。本指南以 learnxinyminutes-docs 仓库中的 英文原文 与 中文译本 为主体,完整覆盖 tmux 的核心命令行操作、前缀快捷键速查表以及一份可实际落地的 ~/.tmux.conf 全量配置,读完即可搭建出一套带自定义前缀键、Vim 风格键位与个性化状态栏的开发环境。

tmux 是什么:先理解"会话—窗口—窗格"三级模型

本仓库的 tmux.md 开篇如此定义:tmux 是一个终端复用器,它使得大量终端可以被创建、访问,并从单个屏幕统一控制;tmux 会话可以与屏幕分离并在后台继续运行,之后可以再次重新接入。

这个定义背后是 tmux 的核心抽象模型,也是理解后续所有命令与快捷键的基础:

  • 会话(Session):一组窗口的容器,是 tmux 的最高层单元。你可以同时开多个会话,每个会话互不干扰,这也是"断开后程序仍在后台运行"的实现单位——断开连接的是客户端(client),会话本体仍在服务器(server)进程中存活。
  • 窗口(Window):会话内部的一个独立终端页面,可以类比浏览器中的一个标签页。一个会话可以拥有多个窗口。
  • 窗格(Pane):窗口内部进一步切分的终端区域,可以左右、上下分割,实现"一个屏幕看多个终端"的效果。

日常使用中最典型的场景是:在远程服务器上执行 tmux 创建会话,运行长时间任务(编译、下载、部署脚本)后按前缀键 d 分离;任务在后台继续执行;下次 SSH 登录后执行 tmux attach 重新接回,工作现场原封不动。这正是文档开篇强调的"may be detached from a screen and continue running in the background then later reattached"。

核心命令行操作速查:会话与窗口的增删查

以下命令表完整继承自 tmux.md,覆盖了 tmux 最常用的 7 组命令及其全部参数:

  tmux [command]     # 运行一条命令
                     # 如果单独使用 'tmux' 而不指定某个命令,将会建立一个新的会话

    new              # 创建一个新的会话
     -s "Session"    # 创建一个会话,并命名为“Session”
     -n "Window"     # 创建一个窗口,并命名为“Window”
     -c "/dir"       # 在指定的工作目录中启动会话

    attach           # 连接到上一次的会话(如果可用)
     -t "#"          # 连接到指定的会话
     -d              # 断开其他客户端的会话

    ls               # 列出打开的会话
     -a              # 列出所有打开的会话

    lsw              # 列出窗口
     -a              # 列出所有窗口
     -s              # 列出会话中的所有窗口

    lsp              # 列出窗格
     -a              # 列出所有窗格
     -s              # 列出会话中的所有窗格
     -t "#"          # 列出指定窗口中的所有窗格

    kill-window      # 关闭当前窗口
     -t "#"          # 关闭指定的窗口
     -a              # 关闭所有窗口
     -a -t "#"       # 关闭除指定窗口以外的所有窗口

    kill-session     # 关闭当前会话
     -t "#"          # 关闭指定的会话
     -a              # 关闭所有会话
     -a -t "#"       # 关闭除指定会话以外的所有会话

命令参数详解与典型用法

  • new(创建会话):tmux new -s work -n editor -c ~/projects/app 会创建一个名为 work 的会话,首个窗口命名为 editor,并在 ~/projects/app 目录下启动。-c 指定工作目录在需要"一键进入项目现场"的场景下非常实用,可以配合后文的 tmuxinator 类工具把整个环境脚本化。
  • attach(重新接入):tmux attach -t work 接入名为 work 的会话;当同一会话已有其他客户端接入时,-d 会先断开那些旧客户端,避免多人/多客户端同时操作同一会话产生画面错乱。
  • ls / lsw / lsp(查询):三者分别列出会话、窗口、窗格。注意 lsw -s 是"列出当前会话中的所有窗口",而 lsp -t "#" 可以指定目标窗口来列出其窗格,便于在脚本中获取窗格编号做自动化操作。
  • kill-window / kill-session(销毁):直接关闭窗口或会话。-a -t "#" 的组合是"保留目标、清除其余",例如 tmux kill-window -a -t 0 保留 0 号窗口并关闭其他所有窗口,适合清理长时间积累的冗余窗口。

从仓库看命令体系的印证

本仓库将该文档归类为 category: tool(见 tmux.md 的文件头 frontmatter),与语言类(language)教程并列,说明其定位是"工具操作手册"而非语言语法讲解。同时 CONTRIBUTING.md 中的风格指南明确要求"Prefer example to exposition(多用示例、少用叙述)",这正是上文命令表采用"命令 + 注释"而非大段文字的原因——读者可以直接把整段复制进终端逐一尝试。

前缀快捷键:控制已接入会话的钥匙

控制一个已接入的 tmux 会话,核心机制是前缀键(Prefix):先按下前缀组合,再按功能键,才能触发对应操作。默认前缀是 C-b(即 Ctrl + b)。以下速查表完整继承自 tmux.md:

----------------------------------------------------------------------
  (C-b) = Ctrl + b    # 在使用下列快捷键之前,需要按这个“前缀”快捷键

  (M-1) = Meta + 1 或 Alt + 1
----------------------------------------------------------------------

  ?                  # 列出所有快捷键
  :                  # 进入 tmux 的命令提示符
  r                  # 强制重绘当前客户端
  c                  # 创建一个新窗口

  !                  # 将当前窗格从窗口中移出,成为为一个新的窗口
  %                  # 将当前窗格分为左右两半
  "                  # 将当前窗格分为上下两半

  n                  # 切换到下一个窗口
  p                  # 切换到上一个窗口
  {                  # 将当前窗格与上一个窗格交换
  }                  # 将当前窗格与下一个窗格交换

  s                  # 在交互式界面中,选择并连接至另一个会话
  w                  # 在交互式界面中,选择并激活一个窗口
  0 至 9             # 选择 0 到 9 号窗口

  d                  # 断开当前客户端
  D                  # 选择并断开一个客户端

  &                  # 关闭当前窗口
  x                  # 关闭当前窗格

  Up, Down           # 将焦点移动至相邻的窗格
  Left, Right

  M-1 到 M-5         # 排列窗格:
                       # 1) 水平等分
                       # 2) 垂直等分
                       # 3) 将一个窗格作为主要窗格,其他窗格水平等分
                       # 4) 将一个窗格作为主要窗格,其他窗格垂直等分
                       # 5) 平铺

  C-Up, C-Down       # 改变当前窗格的大小,每按一次增减一个单位
  C-Left, C-Right

  M-Up, M-Down       # 改变当前窗格的大小,每按一次增减五个单位
  M-Left, M-Right

快捷键分组解读

  • 帮助与命令:? 会列出当前所有绑定的快捷键(含自定义绑定),: 进入类似命令行的 tmux 提示符,可以直接输入 kill-session、set-option 等命令——这是临时调整配置而不修改文件的最快途径。
  • 窗口管理:c 新建窗口、n/p 前后切换、0~9 直达指定编号窗口;& 关闭当前窗口。配合后文 base-index 1 配置后,编号从 1 开始。
  • 窗格操作:% 左右分割、" 上下分割、! 把当前窗格"拆出"成独立新窗口;{/} 交换窗格顺序;方向键在窗格间移动焦点。
  • 复制与历史:[ 进入复制模式(Copy Mode),可以滚动查看历史输出并选择文本(配合后文 mode-keys vi 即可用 Vim 的 hjkl 移动、v 选中、y 复制)。
  • 会话级操作:s 交互式选择并切换会话、d 分离当前客户端、D 选择要分离的客户端。d 是"后台挂机"工作流中最常用的按键。
  • 布局与尺寸:M-1~M-5 一键套用五种布局(水平等分 / 垂直等分 / 主窗格水平 / 主窗格垂直 / 平铺);C-方向键 以 1 格为单位微调当前窗格大小,M-方向键 以 5 格为单位快速调整。

需要特别指出的是,[ 复制模式在原文档快捷键表中被列出,但 tmux.md 的配置示例并未显式绑定复制/粘贴相关按键——这是因为启用 mode-keys vi 后,复制模式会直接采用 Vim 键位(h/j/k/l 移动、v 开始选择、y 复制、Enter 结束选择),无需额外绑定。

配置 ~/.tmux.conf:把环境固化下来

~/.tmux.conf 会在 tmux 启动时自动加载并应用其中的选项,其地位等同于 Vim 用户的 .vimrc 或 Emacs 用户的 init.el。下面这份配置示例完整继承自 tmux.md,分为通用设置、快捷键设置、外观主题、用户界面四大板块,并补充了逐项说明。

通用设置(General)

### 通用设置
###########################################################################

# 启用 UTF-8 编码
setw -g utf8 on
set-option -g status-utf8 on

# 命令回滚/历史数量限制
set -g history-limit 2048

# 从 1 开始编号,而不是从 0 开始
set -g base-index 1

# 启用鼠标
set-option -g mouse-select-pane on

# 重新加载配置文件
unbind r
bind r source-file ~/.tmux.conf
  • UTF-8:setw -g utf8 on 与 set-option -g status-utf8 on 分别对窗口与状态栏启用 UTF-8,保证中文等多字节字符正常显示(英文原版 tmux.md 未含此段,为中文译本 zh-cn/tmux.md 特有的补充)。
  • history-limit 2048:每个窗格在内存中保留的回滚行数上限。数值越大可回看的输出越多,但内存占用也随之上升;2048 是一个兼顾两者的常用值。
  • base-index 1:窗口编号从 1 而不是 0 开始。对习惯"1 号窗口"直觉的用户更友好,也避免了 0 号窗口与部分 Shell 提示符中的 $0 混淆。
  • 鼠标支持:这里值得注意一个版本差异——英文原版 tmux.md 写的是 set-option -g -q mouse on(适用于 tmux 2.1 及以后版本的统一 mouse 选项,-q 表示选项不存在时静默忽略、不报错),而中文译本 zh-cn/tmux.md 写的是 mouse-select-pane on(tmux 2.1 之前按用途拆分的旧选项之一)。如果你的 tmux 较新,请使用英文原版的 mouse on 写法。
  • 热重载:unbind r 先解除默认的 r(重绘)绑定,再 bind r source-file ~/.tmux.conf,使 C-b r 变成"重新加载配置文件",改完配置无需重启会话即可生效,是迭代配置时的关键技巧。

快捷键设置(Keybinds)

### 快捷键设置
###########################################################################

# 取消默认的前缀键 C-b
unbind C-b

# 设置新的前缀键 `
set-option -g prefix `

# 多次按下前缀键时,切换到上一个窗口
bind C-a last-window
bind ` last-window

# 按下F11/F12,可以选择不同的前缀键
bind F11 set-option -g prefix C-a
bind F12 set-option -g prefix `

# Vim 风格的快捷键绑定
setw -g mode-keys vi
set-option -g status-keys vi

# 使用 Vim 风格的按键在窗格间移动
bind h select-pane -L
bind j select-pane -D
bind k select-pane -U
bind l select-pane -R

# 循环切换不同的窗口
bind e previous-window
bind f next-window
bind E swap-window -t -1
bind F swap-window -t +1

# 较易于使用的窗格分割快捷键
bind = split-window -h
bind - split-window -v
unbind '"'
unbind %

# 在嵌套使用 tmux 的情况下,激活最内层的会话,以便向其发送命令
bind a send-prefix
  • 更换前缀键:默认 C-b 与小拇指操作冲突较多(尤其在使用 Emacs 风格终端键位时),这里改用反引号 ` 作为新前缀,手指负担更小。bind last-window 让"连续按两次前缀键"快速回到上一个窗口,类似 cd - 的体验。
  • F11 / F12 动态切换前缀:bind F11 set-option -g prefix C-a 与 bind F12 set-option -g prefix `` `` 允许在运行时把前缀临时切换为 C-a(GNU screen 用户的习惯)或反引号,无需编辑文件即可适应不同习惯。
  • Vim 化:mode-keys vi 让复制模式使用 Vim 键位(h/j/k/l 移动、v 选中、y 复制);status-keys vi 让命令行提示符(C-b :)也支持 Vim 编辑。随后 bind h/j/k/l select-pane -L/-D/-U/-R 把窗格焦点移动也映射成 Vim 方向键——这是"左手不离开主键盘区"工作流的核心。
  • 窗口循环与交换:e/f 分别切换到上一个/下一个窗口;E/F 把当前窗口与前一个/后一个窗口交换位置(swap-window -t -1 / -t +1 表示相对目标)。
  • 一键分割:= 左右分割(split-window -h)、- 上下分割(split-window -v),比记忆默认的 % 和 " 更直观;因此先用 unbind '"' 和 unbind % 解除默认绑定,避免新旧键位冲突。
  • 嵌套 tmux(send-prefix):当你在一台机器上嵌套使用两层 tmux(例如本地 tmux 内 SSH 到服务器再开一层 tmux)时,bind a send-prefix 会把一次前缀按键原样透传给内层会话,使内层 tmux 也能响应快捷键,而不是被外层吞掉。

外观主题(Theme)

### 外观主题
###########################################################################

# 状态栏颜色
set-option -g status-justify left
set-option -g status-bg black
set-option -g status-fg white
set-option -g status-left-length 40
set-option -g status-right-length 80

# 窗格边框颜色
set-option -g pane-active-border-fg green
set-option -g pane-active-border-bg black
set-option -g pane-border-fg white
set-option -g pane-border-bg black

# 消息框颜色
set-option -g message-fg black
set-option -g message-bg green

# 窗口状态栏颜色
setw -g window-status-bg black
setw -g window-status-current-fg green
setw -g window-status-bell-attr default
setw -g window-status-bell-fg red
setw -g window-status-content-attr default
setw -g window-status-content-fg yellow
setw -g window-status-activity-attr default
setw -g window-status-activity-fg yellow
  • 状态栏:status-bg black / status-fg white 定义底栏整体配色;status-left-length 40 / status-right-length 80 限制左右两侧信息区可容纳的字符数,防止过长文本溢出;status-justify left 让窗口列表靠左对齐。
  • 窗格边框:pane-border-fg white 是非活动窗格的边框颜色,pane-active-border-fg green 是高亮当前活动窗格的边框——在多个窗格并存时,绿色边框能让你一眼锁定焦点所在。
  • 消息与窗口状态:message-bg green 为提示消息(如按键绑定列表)配色;窗口状态区分了三种情形——当前窗口(window-status-current-fg green)、收到铃声的窗口(window-status-bell-fg red)、有后台活动的窗口(window-status-activity-fg yellow),构成一套"绿=当前、红=铃响、黄=有动静"的视觉信号系统。

用户界面(UI)

### 用户界面
###########################################################################

# 通知方式
setw -g monitor-activity on
set -g visual-activity on
set-option -g bell-action any
set-option -g visual-bell off

# 自动设置窗口标题
set-option -g set-titles on
set-option -g set-titles-string '#H:#S.#I.#P #W #T' # 窗口编号,程序名称,是否活动

# 调整状态栏
set -g status-left "#[fg=red] #H#[fg=green]:#[fg=white]#S#[fg=green] |#[default]"

# 在状态栏中显示性能计数器
# 需要用到 tmux-mem-cpu-load(第三方插件)
set -g status-interval 4
set -g status-right "#[fg=green] | #[fg=white]#(tmux-mem-cpu-load)#[fg=green] | #[fg=cyan]%H:%M #[default]"
  • 活动与铃声通知:monitor-activity on 监视后台窗口的活动(如日志输出),visual-activity on 用视觉方式(状态栏闪烁标记)代替系统铃声提醒;bell-action any 表示窗口铃声一律触发通知;visual-bell off 则保留系统铃声行为,不与视觉通知叠加。
  • 窗口标题:set-titles on 允许 tmux 修改终端模拟器的标题栏;set-titles-string '#H:#S.#I.#P #W #T' 定义了标题格式——依次为主机名(#H)、会话名(#S)、窗口编号(#I)、窗格编号(#P)、窗口名(#W)与当前程序名(#T),在多个会话间切换时标题栏始终能反映当前位置。
  • 自定义状态栏:status-left 通过 #[fg=red] 这类内联颜色指令拼接出"红色主机名 | 白色会话名"的左侧信息;status-right 借助 #(tmux-mem-cpu-load) 语法调用外部程序并把其标准输出嵌入状态栏,status-interval 4 控制刷新间隔为 4 秒。注意 tmux-mem-cpu-load 是第三方独立工具,需要单独安装后该行才会生效,未安装时该位置会显示空串,不影响其他配置。

从仓库看这份教程的来龙去脉

  • 多语言生态:这份 tmux 教程在仓库内拥有完整的翻译矩阵:英文原版 tmux.md(作者 mdln)、中文版(译者 Arnie97)、西班牙语版、法语版,以及 葡萄牙语版、俄语版、立陶宛语版。对比各版本可以发现:中文版补充了 UTF-8 设置并使用了更早期的鼠标选项命名,英文原版则采用 mouse on 的新式写法——在参考多语言版本时,建议以英文原版为最新语义基准。
  • 文档规范:本教程的文件头(frontmatter)声明了 category: tool、name: tmux、contributors 与 filename: LearnTmux.txt 等元数据,这些字段的合法性由 lint/frontmatter.py 脚本校验;CONTRIBUTING.md 则规定"每行尽量不超过 80 字符、代码块优先于文字叙述、使用 UTF-8"等写作约束。若你想为 tmux 教程贡献新语言的翻译,遵循上述 frontmatter 与行宽规范即可与仓库现有版本保持风格一致。

进阶方向与仓库内延伸阅读

原文档在结尾列出了一组进阶参考,这里将其收敛为可继续深挖的主题(工具名称保留、链接请自行检索):

  • 会话编排:tmuxinator 等第三方工具可以把"创建多个会话/窗口/窗格并执行指定命令"的启动流程固化成 YAML 配置文件,实现一条命令还原整个开发环境——这与本教程 new -s/-n/-c 手动参数是同一目标的不同自动化层级。
  • 状态栏增强:tmux-mem-cpu-load 可在状态栏中显示 CPU/内存占用百分比,配合文中的 status-interval 与 #() 内联执行语法即可接入。
  • 官方手册:tmux 的 man 手册是命令与选项的最权威来源;Gentoo 与 Arch Linux 的 Wiki 则提供了发行版相关的安装与故障排查细节。

回到本仓库,若想继续学习同风格的终端工具教程,可翻阅根目录下的 git.md、bash.md、vim.md 等同为 category: tool 的文档,它们与 tmux.md 遵循完全相同的"命令表 + 配置示例"结构,适合组合阅读、构建一套完整的命令行工作流。

核心要点回顾:会话/窗口/窗格三级模型决定了 tmux 的一切操作;前缀键(默认 C-b,可改为反引号)是快捷键体系的入口;~/.tmux.conf 从通用设置、键位、主题到 UI 的四段式结构,足以覆盖日常开发环境的全部定制需求;而"分离后后台运行、随时重接"的能力,则是远程开发与长时间任务场景下 tmux 不可替代的价值所在。

登录后查看全文
learnxinyminutes-docs