tmux 终端复用器实战指南:命令速查、前缀快捷键与 ~/.tmux.conf 深度配置(learnxinyminutes-docs)
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 风格终端键位时),这里改用反引号`作为新前缀,手指负担更小。bindlast-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 不可替代的价值所在。