tmux命令

May 20, 2023

tmux

terminal multiplexer
tmux 是一个终端复用器
（注：tmux 来自于 OpenBSD）

https://github.com/tmux/tmux/wiki/Getting-Started
https://wiki.archlinuxcn.org/wiki/Tmux
https://learnxinyminutes.com/docs/zh-cn/tmux-cn/

tmux 的主要用途是：

通过将程序运行在 tmux 中，以防止远程服务器连接断开时程序终止运行
允许将程序运行在远程服务器上，然后被多台本地主机访问
在一个终端中运行多个程序和 shell，有点像窗口管理器

https://man.openbsd.org/tmux

$ man 1 tmux

tmux_pane_diagram

术语

术语	描述
Client	可以通过类似于 xterm 的终端 attach 到一个 tmux 的 session
Session	一个或一组 window
Window	一个或一组 pane
Pane	包含一个终端和运行中的程序，出现在一个 window 中
Active pane	current window 中的 pane
Current window	attached session 中的 window （where typing is sent）
Last window	上一个 current window
Session name	session 的名称，默认从 0 开始计数
Window list	一个 session 中的 window 列表，按编号的大小排序
Window name	window 的名称，默认是当前 active pane 中运行着的程序的名称
Window index	window 在一个 session 的 window list 中的编号
Window layout	window 中的所有 pane 中的尺寸和位置

交互式（命令行）

当一个 tmux 的 client 被 attach，屏幕底部将显示一条状态栏

tmux_status_line_diagram

session

# 创建一个 session 并 attach
tmux new
tmux new-session

# session 默认从 0 开始命名，可以手动指定名称
tmux new -s my_session_name

# 默认情况下 tmux 会 attach 到新建的 session，并运行 shell
# 可以给定一个命令，tmux 就会将其传递给 shell
# 注：不会新建 session，也不会 attach
tmux new 'emacs ~/.tmux.conf'
# or
tmux new -- emacs ~/.tmux.conf

# 默认情况下 tmux 会在 session 中的第一个 window 中运行命令
# 可以给定 -n 选项，指定一个 window 来运行命令
tmux new -n mytopwindow -- top

attach 和 detach

detach 意味着 client 存在的情况下从终端外部分离，回到 shell 并使 tmux 中运行的程序在后台运行

# C-b d
tmux detach

tmux attach
tmux attach-session

# attach 到指定 session
tmux attach -t <session-name>

# -d 选项，attach 到终端时使其它 client 被 detach
tmux attach -dt <session-name>

# new-session 子命令提供 -A 选项，允许 attach 到指定 session
# 若指定 session 不存在则创建
tmux new -As <session-name>

# 列出所有可被 attach 的 session
tmux ls
tmux list-session

# 若 tmux 中没有 session、window 和 pane，tmux 将自动 exit
# 也可以使用此命令关闭
tmux kill-server

tmux kill-session -t <session-name>

tmux switch -t <session-name>

tmux swap-window

tmux move-window

tmux swap-pane

# 重命名 session
# C-b $
tmux rename-session -t <session-name> <new-name>

# 重命名 window
# C-b ,
tmux rename-window -t <window-name> <new-name>

# 列出所有子目录
tmux list-commands

# 列出所有快捷键
tmux list-keys

predix key

当一个 tmux 的 client 被 attach，键盘输入将转发到 current window 中的 active pane 中运行的程序。
prefix key 是特殊的快捷键，可用于控制 tmux 自身

注：C=Ctrl M=Meta=Alt

tmux 的快捷键前缀是 C-b，按下 Ctrl+B 并松开
再按下 ? 可以查看快捷键列表
按两次 C-b 可向程序本身发送一次 Ctrl+B

分割 window

# 默认上下分
tmux splitw
tmux split-window

# 上下分
#  C-b "
tmux splitw -v

# 左右分
# C-b %
tmux splitw -h

# 打印 pane 各自的序号
# C-b q
tmux display-panes

# 切换到指定序号
# C-b q <序号>
tmux select-pane <序号>

# 通过上下左右键切换 pane
# C-b Up  C-b Down  C-b Left  C-b Right

# 切换到下一个 pane
# C-b o

# 将下一个 pane 的内容与 当前 pane 交换
# C-b C-o

# kill 当前 window（包含所有 pane）
# C-b &
tmux kill-window

# kill 选中的 pane
# C-b x
tmux kill-pane

树模式将窗口分为上下两个部分：
上面是 session-window-pane 树
下面是 pane 的预览区域

# 进入 tree 模式
tmux choose-tree
# C-b s
# C-b w

Key	Function
`Up` `Down`	在树中导航
`Left`	折叠
`Right`	展开
`Enter`	进入到选择的项目（变为被 attach 的 session）
`O`	改变项目的顺序
`q`	退出
`t`	选中（tag）或取消选中当前项目
`T`	全部取消选中
`C-t`	选中所有项目
`x`	kill 当前项目
`X`	kill 所有被 tag 的项目
`v`	打开或关闭下半部分的预览

detach 其它 client

# 进入 client 模式
# C-b D

Key	Function
`Enter`	detach 当前 client
`d`	同上
`D`	detach 选中的（tagged）client
`x`	detach 当前 client 并尝试 kill 其启动的 shell
`X`	detach 选中的（tagged） client 并尝试 kill 其启动的 shell

调整 pane 大小

tmux resize-pane

调小 C-b C-Left C-b C-Right C-b C-Up C-b C-Down

调大 C-b M-Left C-b M-Right C-b M-Up C-b M-Down

Key	Function
`C-b z`	将当前全屏，再按一次退出全屏
`C-b Space`	旋转布局

Name	Key	Description
even-horizontal	`C-b M-1`	Spread out evenly across
even-vertical	`C-b M-2`	Spread out evenly up and down
main-horizontal	`C-b M-3`	One large pane at the top, the rest spread out evenly across
main-vertical	`C-b M-4`	One large pane on the left, the rest spread out evenly up and down
tiled	`C-b M-5`	Tiled in the same number of rows as columns

command prompt

C-b :

tmux_command_prompt

支持鼠标操作（右键）

tmux set-option mouse on
# :set -g mouse on

←Back to home