名 稱

tmux — 終 端 多 路 複 用 器

概 要

tmux [-2CDlNuVv] [-c 外 殼 命 令 ] [-f 檔 案 ] [-L 套 接 字 名 稱 ] [-S 套 接 字 路 徑 ] [-T 特 徵 ] [命 令  [符 號 ]]

描 述

tmux 是 一 個 終 端 多 路 複 用 器 ： 它 允 許 從 單 個 螢 幕 建 立 、 訪 問 和 控 制 多 個 終 端 。 tmux 可 以 從 螢 幕 上 分 離 並 繼 續 在 後 臺 執 行 ， 然 後 重 新 附 加 。

tmux 被 啟 動 時 ， 會 建 立 一 個 新 的 會 話 ， 其 中 包 含 一 個 視 窗 並 將 其 顯 示 在 螢 幕 上 。 螢 幕 底 部 的 狀 態 行 顯 示 當 前 會 話 資 訊 ， 並 用 於 輸 入 互 動 式 命 令 。

會 話 是 tmux 管 理 的 一 組 偽 終 端 ， 每 個 會 話 都 有 一 個 或 多 個 與 其 關 聯 的 窗 口 。 一 個 窗 口 占 據 整 個 螢 幕 ， 可 以 分 成 多 個 矩 形 窗 格 ， 每 個 窗 格 都 是 一 個 單 獨 的 偽 終 端 （ 關 於 偽 終 端 的 技 術 細 節 可 以 參 考 pty(4) 手 冊 頁 面 ） 。 任 意 數 量 的 tmux 實 例 可 以 連 線 到 同 一 個 會 話 ， 同 一 會 話 中 可 以 存 在 任 意 數 量 的 視 窗 。 當 所 有 會 話 都 被 關 閉 時 ， tmux 退 出 。

每 個 會 話 都 是 持 久 的 ， 即 使 發 生 意 外 斷 開 （ 如 ssh(1) 連 線 超 時 ） 或 意 外 分 離 （ 使 用 ’C-b d’ 組 合 鍵 ） 也 會 保 留 。 可 以 使 用 以 下 命 令 重 新 連 線 tmux ：

$ tmux attach

tmux 在 螢 幕 上 由 客 戶 端 顯 示 ， 所 有 會 話 由 單 個 伺 服 器 管 理 。 服 務 器 和 每 個 客 戶 端 都 是 獨 立 的 程 序 ， 它 們 透 過 /tmp 中 的 一 個 套 接 字 進 行 通 訊 。

選 項 如 下 ：

-2

強 制 tmux 假 定 終 端 支 援 256 種 顏 色 。 這 相 當 於 -T 256 。

-C

以 控 制 模 式 啟 動 （ 請 參 閱 CONTROL MODE 章 節 ） 。 兩 次 給 出 (

-CC) 可 以 禁 用 回 顯 。

-c 外 殼 命 令

使 用 預 設 shell 執 行 shell-command 。 如 果 必 要 ， tmux 伺 服 器 會 啟 動 以 檢 索 default-shell 選 項 。 當 tmux 用 作 登 入 shell 時 ， 此 選 項 用 於 與 sh(1) 相 容 。

-D

不 要 將 tmux 伺 服 器 作 為 守 護 程 序 啟 動 。 這 也 會 關 閉 exit-empty 選 項 。 使 用 -D ， 不 可 以 指 定 command 。

-f 檔 案

指 定 替 代 配 置 檔 案 。 預 設 情 況 下 ， tmux 從 @SYSCONFDIR@/tmux.conf 載 入 系 統 配 置 檔 案 （ 如 果 存 在 ） ， 然 後 在 ~/.tmux.conf 、 $XDG_CONFIG_HOME/tmux/tmux.conf 或 ~/.config/tmux/tmux.conf 中 查 詢 使 用 者 配 置 檔 案 。

配 置 檔 案 是 一 組 tmux 命 令 ， 這 些 命 令 在 伺 服 器 第 一 次 啟 動 時 按 順 序 執 行 。 tmux 在 伺 服 器 程 序 啟 動 時 載 入 配 置 檔 案 。 可 以 使 用 source-file 命 令 在 後 面 載 入 文 件 。

tmux 會 在 建 立 的 第 一 個 會 話 中 顯 示 來 自 配 置 檔 案 中 命 令 的 任 何 錯 誤 訊 息 ， 並 繼 續 處 理 配 置 檔 案 的 其 餘 部 分 。

-L 套 接 字 名 稱

tmux 將 伺 服 器 套 接 字 儲 存 在 TMUX_TMPDIR 或 /tmp 下 的 目 錄 中 （ 如 果 未 設 定 ） 。 預 設 套 接 字 名 稱 為 default 。 此 選 項 允 許 指 定 不 同 的 套 接 字 名 稱 ， 從 而 允 許 執 行 多 個 獨 立 的 tmux 伺 服 器 。 與 -S 不 同 ， 不 需 要 提 供 完 整 路 徑 ： 所 有 套 接 字 都 建 立 在 由 TMUX_TMPDIR 給 出 的 目 錄 下 的 tmux-UID 目 錄 中 ， 或 者 在 /tmp 中 。 tmux 建 立 tmux-UID 目 錄 ， 並 且 不 能 將 其 設 定 為 全 域 性 可 讀 、 可 寫 或 可 執 行 。

如 果 套 接 字 被 意 外 刪 除 ， 可 以 向 tmux 伺 服 器 程 序 傳 送 SIGUSR1 訊 號 以 重 新 建 立 它 （ 請 注 意 ， 如 果 缺 少 任 何 父 目 錄 ， 則 此 操 作 將 失 敗 ） 。

-l

表 現 為 登 入 shell。 目 前 此 標 誌 沒 有 實 際 效 果 ， 只 是 為 了 與 其 他 shell 在 使 用 tmux 作 為 登 入 shell 時 相 容 。

-N

即 使 命 令 通 常 會 啟 動 伺 服 器 （ 例 如 new-session 或 start-server ） ， 也 不 要 啟 動 伺 服 器 。

-S 套 接 字 路 徑

指 定 伺 服 器 套 接 字 的 完 整 替 代 路 徑 。 如 果 指 定 了 -S ， 則 不 使 用 預 設 套 接 字 目 錄 ， 任 何 -L 標 誌 都 將 被 忽 略 。

-u

即 使 設 定 的 第 一 個 LC_ALL 、 LC_CTYPE 或 LANG 環 境 變 數 不 包 含 "UTF-8" 或 "UTF8" ， 也 將 UTF-8 輸 出 寫 入 終 端 。 這 相 當 於 -T UTF-8 。

-T 特 徵

為 客 戶 端 設 定 終 端 特 性 。 這 是 一 個 用 逗 號 分 隔 的 特 性 列 表 。 請 參 閱 terminal-features 選 項 。

-v

請 求 詳 細 日 誌 記 錄 。 日 誌 訊 息 將 儲 存 在 當 前 目 錄 中 的 tmux-client-PID.log 和 tmux-server-PID.log 檔 案 中 ， 其 中 PID 是 伺 服 器 或 客 戶 端 程 序 的 PID。 如 果 指 定 了 -v 兩 次 ， 則 會 生 成 另 一 個 名 為 tmux-out-PID.log 的 檔 案 ， 其 中 包 含 tmux 寫 入 終 端 的 所 有 內 容 的 副 本 。

可 以 向 tmux 伺 服 器 程 序 傳 送 SIGUSR2 訊 號 ， 以 在 開 啟 日 誌 記 錄 （ 如 同 給 出 -v ） 和 關 閉 日 誌 記 錄 之 間 切 換 。

-V

報 告 tmux 的 版 本 。

命 令 [符 號 ]

此 選 項 指 定 用 於 控 制 tmux 的 一 組 命 令 ， 如 下 面 的 章 節 中 所 述 。 如 果 沒 有 指 定 命 令 ， 則 假 定 使 用 new-session 命 令 。

預 設 按 鍵 繫 結

可 以 使 用 字 首 鍵 （ 預 設 為 ’C-b’ ， 即 Ctrl-b） 加 上 一 個 命 令 鍵 來 控 制 tmux 。 通 過 一 個 已 連 線 的 客 戶 端 可 以 實 現 這 種 控 制 。

預 設 的 命 令 鍵 繫 結 如 下 ：

C-b

將 字 首 鍵 （ C-b） 傳 送 到 應 用 程 式 。

C-o

向 前 旋 轉 當 前 視 窗 中 的 窗 格 。

C-z

掛 起 tmux 客 戶 端 。

!

將 當 前 窗 格 從 視 窗 中 分 離 。

"

將 當 前 窗 格 分 為 上 下 兩 部 分 。

#

列 出 所 有 剪 貼 簿 。

$

重 新 命 名 當 前 會 話 。

%

將 當 前 窗 格 分 為 左 右 兩 部 分 。

&

關 閉 當 前 視 窗 。

’

提 示 選 擇 視 窗 索 引 。

(

將 所 附 加 的 客 戶 端 切 換 到 前 一 個 會 話 。

)

將 所 附 加 的 客 戶 端 切 換 到 下 一 個 會 話 。

,

重 新 命 名 當 前 視 窗 。

-

刪 除 最 近 複 製 的 文 字 緩 衝 區 。

.

提 示 輸 入 要 移 動 當 前 視 窗 的 索 引 。

0 到 9

選 擇 視 窗 0 到 9。

:

進 入 tmux 命 令 提 示 符 。

;

移 動 到 先 前 活 動 的 窗 格 。

=

從 列 表 中 互 動 式 選 擇 要 貼 上 的 緩 衝 區 。

?

列 出 所 有 按 鍵 繫 結 。

D

選 擇 要 分 離 的 客 戶 端 。

L

將 所 附 加 的 客 戶 端 切 換 回 上 一 個 會 話 。

[

進 入 複 製 模 式 以 複 製 文 字 或 檢 視 歷 史 記 錄 。

]

貼 上 最 近 複 製 的 文 字 緩 衝 區 。

c

建 立 一 個 新 視 窗 。

d

分 離 當 前 客 戶 端 。

f

提 示 在 開 啟 的 視 窗 中 搜 索 文 字 。

i

顯 示 有 關 當 前 視 窗 的 一 些 資 訊 。

l

移 動 到 先 前 選 擇 的 視 窗 。

m

標 記 當 前 窗 格 （ 參 見 select-pane -m ） 。

M

清 除 標 記 的 窗 格 。

n

切 換 到 下 一 個 視 窗 。

o

在 當 前 視 窗 中 選 擇 下 一 個 窗 格 。

p

切 換 到 上 一 個 視 窗 。

q

簡 要 顯 示 窗 格 索 引 。

r

強 制 重 繪 附 加 的 客 戶 端 。

s

以 互 動 方 式 為 連 線 的 客 戶 端 選 擇 一 個 新 會 話 。

t

顯 示 時 間 。

w

互 動 地 選 擇 當 前 視 窗 。

x

關 閉 當 前 窗 格 。

z

切 換 當 前 窗 格 的 縮 放 狀 態 。

{

將 當 前 窗 格 與 上 一 個 窗 格 交 換 。

}

將 當 前 窗 格 與 下 一 個 窗 格 交 換 。

~

如 果 有 的 話 ， 顯 示 tmux 的 以 前 訊 息 。

Page Up

進 入 影 印 模 式 並 向 上 滾 動 一 頁 。

Up, Down
Left, Right

切 換 到 當 前 窗 格 上 方 、 下 方 、 左 側 或 右 側 的 窗 格 。

M-1 到 M-5

將 窗 格 排 列 為 五 個 預 設 佈 局 之 一 ： even-horizontal、 even-vertical、 main-horizontal、 main-vertical 或 tiled。

Space

在 下 一 個 預 設 佈 局 中 排 列 當 前 視 窗 。

M-n

使 用 鈴 聲 或 活 動 標 記 移 動 到 下 一 個 視 窗 。

M-o

向 後 旋 轉 當 前 視 窗 中 的 窗 格 。

M-p

使 用 鈴 聲 或 活 動 標 記 移 動 到 上 一 個 視 窗 。

C-Up, C-Down
C-Left, C-Right

以 一 個 單 元 格 為 單 位 調 整 當 前 窗 格 的 大 小 。

M-Up, M-Down
M-Left, M-Right

以 五 個 單 元 格 為 步 長 調 整 當 前 窗 格 的 大 小 。

可 以 使 用 bind-key 和 unbind-key 命 令 更 改 鍵 繫 結 。

命 令 解 析 和 執 行

tmux 支 援 大 量 命 令 ， 可 用 於 控 制 其 行 為 。 每 個 命 令 都 有 名 稱 ， 可 以 接 受 零 個 或 多 個 標 志 和 引 數 。 它 們 可 以 使 用 bind-key 命 令 繫 結 到 鍵 上 ， 也 可 以 從 shell 提 示 符 、 shell 指 令 碼 、 配 置 檔 案 或 命 令 提 示 符 中 執 行 。 例 如 ， 從 shell 提 示 符 、 ~/.tmux.conf 和 繫 結 到 鍵 的 相 同 的 set-option 命 令 可 能 如 下 所 示 ：

$ tmux set-option -g status-style bg=cyan

set-option -g status-style bg=cyan

bind-key C set-option -g status-style bg=cyan

這 裡 ， 命 令 名 稱 是 ’set-option’ ， ’-g’ 是 一 個 標 誌 ， ’status-style’ 和 ’bg=cyan’ 是 引 數 。

tmux 區 分 命 令 解 析 和 執 行 。 為 了 執 行 命 令 ， tmux 需 要 將 其 拆 分 為 名 稱 和 引 數 。 這 是 命 令 解 析 。 如 果 從 shell 中 執 行 命 令 ， 則 shell 解 析 它 ； 如 果 從 tmux 內 部 或 配 置 檔 案 中 執 行 ， 則 tmux 解 析 它 。 tmux 解 析 命 令 的 示 例 包 括 ：

-

在 配 置 檔 案 中 ；

-

在 命 令 提 示 符 下 輸 入 （ 參 見 command-prompt ） ；

-

給 予 bind-key ；

-

作 為 引 數 傳 遞 給 if-shell 或 confirm-before 。

為 了 執 行 命 令 ， 每 個 客 戶 端 都 有 一 個 ’命 令 佇 列 ’ 。 在 啟 動 時 ， 未 附 加 到 任 何 客 戶 端 的 全 域 性 命 令 佇 列 用 於 像 ~/.tmux.conf 這 樣 的 配 置 檔 案 。 新 增 到 佇 列 中 的 解 析 命 令 按 順 序 執 行 。 某 些 命 令 （ 例 如 if-shell 和 confirm-before ） 會 解 析 其 引 數 以 建 立 一 個 新 命 令 ， 該 命 令 立 即 插 入 到 它 們 之 後 。 這 意 味 著 引 數 可 能 會 被 解 析 兩 次 或 更 多 次 ——一 次 是 在 解 析 其 父 命 令 （ 如 if-shell ） 時 ， 再 次 是 在 解 析 並 執 行 其 命 令 時 。 命 令 ， 例 如 if-shell 、 run-shell 和 display-panes ， 會 停 止 佇 列 中 後 續 命 令 的 執 行 ， 直 到 發 生 某 些 事 情 —— if-shell 和 run-shell 直 到 外 殼 命 令 完 成 ， display-panes 直 到 按 下 鍵 。 例 如 ， 以 下 命 令 ：

new-session; new-window
if-shell "true" "split-window"
kill-session

將 按 照 順 序 執 行 new-session 、 new-window 、 if-shell 、 shell 命 令 true(1) 、 split-window 和 kill-session 。

命 令 部 分 列 出 了 tmux 命 令 及 其 引 數 。

解 析 語 法

本 節 描 述 由 tmux 解 析 的 命 令 的 語 法 ， 例 如 在 配 置 檔 案 或 命 令 提 示 符 中 。 請 注 意 ， 當 命 令 輸 入 到 shell 中 時 ， 它 們 由 shell 解 析 ——例 如 參 見 ksh(1) 或 csh(1) 。

每 個 命 令 以 換 行 符 或 分 號 (;) 結 尾 。 由 分 號 分 隔 的 命 令 一 起 形 成 一 個 ’命 令 序 列 ’ ——如 果 序 列 中 的 一 個 命 令 遇 到 錯 誤 ， 則 不 會 執 行 後 續 命 令 。

建 議 將 用 作 命 令 分 隔 符 的 分 號 寫 成 單 獨 的 標 記 ， 例 如 從 sh(1) ：

$ tmux neww \; splitw

或 ：

$ tmux neww ’;’ splitw

或 者 從 tmux 命 令 提 示 符 ：

neww ; splitw

然 而 ， 尾 隨 的 分 號 也 被 解 釋 為 一 個 命 令 分 隔 符 。 例 如 ， 在 這 些 sh(1) 命 令 中 ：

$ tmux neww\; splitw

或 ：

$ tmux ’neww;’ splitw

就 像 這 些 例 子 一 樣 ， 當 從 shell 執 行 tmux 時 ， 必 須 特 別 小 心 地 引 用 分 號 ：

1.

應 該 被 解 釋 為 命 令 分 隔 符 的 分 號 應 該 根 據 shell 約 定 進 行 轉 義 。 對 於 sh(1) ， 這 通 常 意 味 著 使 用 引 號 引 用 (例 如 ’neww ’;’ splitw’) 或 者 轉 義 (例 如 ’neww \\\\; splitw’) 。

2.

應 該 被 解 釋 為 引 數 的 單 個 分 號 或 尾 隨 分 號 應 該 進 行 兩 次 轉 義 ： 一 次 根 據 shell 約 定 轉 義 ， 另 一 次 為 了 tmux 轉 義 ； 例 如 ：

$ tmux neww ’foo\\;’ bar
$ tmux neww foo\\\\; bar

3.

不 是 單 獨 的 標 記 或 尾 隨 另 一 個 標 記 的 分 號 應 該 根 據 shell 約 定 只 轉 義 一 次 ； 例 如 ：

$ tmux neww ’foo-;-bar’
$ tmux neww foo-\\;-bar

註 釋 由 未 引 用 的 # 字 元 標 記 ——在 註 釋 後 的 任 何 剩 餘 文 字 都 會 被 忽 略 ， 直 到 行 末 。

如 果 一 行 的 最 後 一 個 字 元 是 \， 則 該 行 與 下 一 行 連 線 （ \ 和 換 行 符 都 被 完 全 刪 除 ） 。 這 被 稱 為 行 連 續 ， 適 用 於 引 用 字 串 內 外 和 註 釋 內 ， 但 不 適 用 於 花 括 號 內 部 。

命 令 引 數 可 以 被 指 定 為 被 單 引 號 （ ’） ， 雙 引 號 (") 或 者 花 括 號 ({}) 包 圍 的 字 串 。 當 引 數 包 含 任 何 特 殊 字 元 時 ， 這 是 必 需 的 。 單 引 號 和 雙 引 號 的 字 串 不 能 跨 越 多 行 ， 除 非 使 用 行 連 續 。 花 括 號 可 以 跨 越 多 行 。

在 引 號 之 外 和 雙 引 號 之 內 ， 執 行 以 下 替 換 ：

-

由 $ 字 首 的 環 境 變 數 將 被 替 換 為 它 們 在 全 域 性 環 境 中 的 值 （ 請 參 閱 全 域 性 和 會 話 環 境 部 分 ） 。

-

以 ~ 或 ~user 開 頭 將 被 擴 充 套 件 為 當 前 或 指 定 使 用 者 的 主 目 錄 。

-

\uXXXX 或 \uXXXXXXXX 將 被 替 換 為 與 給 定 的 四 位 或 八 位 十 六 進 位 制 數 對 應 的 Unicode 程 式 碼 點 。

-

當 由 \ 字 首 （ 轉 義 ） 時 ， 以 下 字 元 將 被 替 換 ： \e 為 跳 脫 字 元 ； \r 為 回 車 符 ； \n 為 換 行 符 ； \t 為 製 表 符 。

-

\ooo 將 被 替 換 為 一 個 八 進 位 制 值 為 ooo 的 字 元 。 需 要 三 個 八 進 位 制 數 字 ， 例 如 \001。 最 大 有 效 字 元 是 \377。

-

\ 後 面 的 任 何 其 他 字 元 都 將 被 替 換 為 它 們 自 己 （ 即 ， \ 將 被 刪 除 ） ， 並 且 不 被 視 為 具 有 任 何 特 殊 含 義 ——因 此 例 如 \; 不 會 標 記 命 令 序 列 ， \$ 不 會 展 開 環 境 變 數 。

花 括 號 被 解 釋 為 配 置 檔 案 （ 因 此 可 以 處 理 ’%if’ 等 條 件 ） ， 然 後 轉 換 為 字 串 。 它 們 旨 在 避 免 在 將 一 組 tmux 命 令 作 為 引 數 傳 遞 時 需 要 進 行 額 外 的 轉 義 （ 例 如 傳 遞 給 if-shell ） 。 這 兩 個 例 子 生 成 相 同 的 命 令 - 請 注 意 ， 使 用 {} 時 不 需 要 進 行 任 何 轉 義 ：

if-shell true {
display -p ’brace-dollar-foo: }$foo’
}

if-shell true "display -p ’brace-dollar-foo: }\$foo’"

大 括 號 可 以 包 含 在 大 括 號 內 ， 例 如 ：

bind x if-shell "true" {
if-shell "true" {
display "true!"
}
}

可 以 使 用 語 法 ’name=value’ 來 設 定 環 境 變 數 ， 例 如 ’HOME=/home/user’ 。 在 解 析 期 間 設 定 的 變 數 將 新 增 到 全 域 性 環 境 中 。 可 以 使 用 ’%hidden’ 設 定 隱 藏 變 量 ， 例 如 ：

%hidden MYVAR=42

隱 藏 變 數 不 會 傳 遞 給 由 tmux建 立 的 程 序 的 環 境 變 數 。 請 參 見 GLOBAL AND SESSION ENVIRONMENT 部 分 。

可 以 使 用 ’%if’ 、 ’%elif’ 、 ’%else’ 和 ’%endif’ 將 命 令 進 行 條 件 解 析 。 ’%if’ 和 ’%elif’ 的 引 數 會 被 擴 充 套 件 為 格 式 化 字 串 （ 參 見 FORMATS ） ， 如 果 它 們 的 值 為 false（ 零 或 空 ） ， 那 麼 後 續 的 文 字 將 被 忽 略 ， 直 到 遇 到 ’%elif’ 、 ’%else’ 或 ’%endif’ 。 例 如 ：

%if "#{==:#{host},myhost}"
set -g status-style bg=red
%elif "#{==:#{host},myotherhost}"
set -g status-style bg=green
%else
set -g status-style bg=blue
%endif

如 果 在 ’myhost’ 上 執 行 ， 則 將 狀 態 行 更 改 為 紅 色 ， 如 果 在 ’myotherhost’ 上 執 行 ， 則 更 改 為 綠 色 ， 如 果 在 另 一 個 主 機 上 執 行 ， 則 更 改 為 藍 色 。 條 件 語 句 可 以 寫 在 一 行 上 ， 例 如 ：

%if #{==:#{host},myhost} set -g status-style bg=red %endif

命 令

本 節 介 紹 了 tmux 支 援 的 命 令 。 大 多 數 命 令 都 接 受 可 選 的 -t （ 有 時 還 有 -s ） 引 數 和 目 標 客 戶 端 、 目 標 會 話 、 目 標 視 窗 或 目 標 窗 格 之 一 。 這 些 指 定 了 命 令 要 影 響 的 客 戶 端 、 會 話 、 視 窗 或 窗 格 。

本 節 介 紹 tmux 支 援 的 命 令 。 大 多 數 命 令 都 可 以 使 用 可 選 的 -t （ 有 時 還 有 -s ） 引 數 ， 引 數 可 以 是 target-client 、 target-session 、 target-window 或 target-pane ， 用 於 指 定 命 令 應 該 影 響 哪 個 客 戶 端 、 會 話 、 視 窗 或 窗 格 。

target-session 嘗 試 的 順 序 如 下 ：

1.

以 $ 為 字 首 的 會 話 代 號 。

2.

會 話 的 精 確 名 稱 （ 由 list-sessions 命 令 列 出 ） 。

3.

會 話 名 稱 的 開 頭 ， 例 如 ’mysess’ 可 以 匹 配 名 為 ’mysession’ 的 會 話 。

4.

與 會 話 名 稱 匹 配 的 fnmatch(3) 模 式 。

如 果 會 話 名 稱 以 ’=’ 開 頭 ， 則 只 接 受 精 確 匹 配 （ 因 此 ’=mysess’ 只 能 精 確 匹 配 ’mysess’ ， 而 不 能 匹 配 ’mysession’ ） 。

如 果 找 到 一 個 會 話 ， 則 將 其 用 作 目 標 會 話 ； 多 個 匹 配 會 產 生 錯 誤 。 如 果 省 略 會 話 ， 則 使 用 當 前 可 用 的 會 話 ； 如 果 沒 有 當 前 會 話 可 用 ， 則 選 擇 最 近 使 用 的 會 話 。

target-window （ 或 src-window 或 dst-window ） 指 定 一 個 窗 口 ， 格 式 為 session:window 。 session 的 規 則 與 target-session 的 規 則 相 同 ， 並 且 按 以 下 順 序 查 詢 window ：

1.

一 個 特 殊 的 令 牌 ， 如 下 所 列 。

2.

視 窗 索 引 ， 例 如 ’mysession:1’ 是 會 話 ’mysession’ 中 的 第 一 個 視 窗 。

3.

視 窗 ID， 例 如 @1。

4.

一 個 精 確 的 視 窗 名 稱 ， 例 如 ’mysession:mywindow’ 。

5.

視 窗 名 稱 的 開 頭 ， 例 如 ’mysession:mywin’ 。

6.

與 視 窗 名 稱 匹 配 的 fnmatch(3) 模 式 。

與 會 話 類 似 ， ’=’ 字 首 只 進 行 精 確 匹 配 。 如 果 視 窗 名 稱 為 空 ， 則 如 果 適 用 ， 指 定 下 一 個 未 使 用 的 索 引 （ 例 如 new-window 和 link-window 命 令 ） ； 否 則 將 選 擇 session 中 的 當 前 視 窗 。

以 下 特 殊 標 記 可 用 於 指 示 特 定 視 窗 。 每 個 標 記 都 有 一 個 單 字 元 的 替 代 形 式 。

標 記 Flag 含 義
{start} ^ 編 號 最 小 的 視 窗
{end} $ 編 號 最 大 的 視 窗
{last} ! 上 一 個 （ 之 前 的 當 前 ） 視 窗
{next} + 下 一 個 視 窗 的 編 號
{previous} - 上 一 個 視 窗 的 編 號

target-pane （ 或 src-pane 或 dst-pane ） 可 以 是 窗 格 ID， 也 可 以 採 用 與 target-window 類 似 的 形 式 ， 但 是 可 以 選 擇 在 視 窗 名 稱 後 面 加 上 一 個 點 和 窗 格 索 引 或 窗 格 ID， 例 如 ： ’mysession:mywindow.1’ 。 如 果 省 略 了 窗 格 索 引 ， 則 使 用 指 定 視 窗 中 當 前 活 動 的 窗 格 。 以 下 是 用 於 窗 格 索 引 的 特 殊 標 記 ：

標 記 Flag 含 義
{last} ! 最 後 一 個 （ 以 前 活 動 的 ） 窗 格
{next} + 下 一 個 窗 格 （ 按 編 號 ）
{previous} - 上 一 個 窗 格 （ 按 編 號 ）
{top} 頂 部 窗 格
{bottom} 底 部 窗 格
{left} 最 左 邊 的 窗 格
{right} 最 右 邊 的 窗 格
{top-left} 左 上 窗 格
{top-right} 右 上 窗 格
{bottom-left} 左 下 方 的 窗 格
{bottom-right} 右 下 窗 格
{up-of} 活 動 窗 格 上 方 的 窗 格
{down-of} 活 動 窗 格 下 方 的 窗 格
{left-of} 活 動 窗 格 左 側 的 窗 格
{right-of} 活 動 窗 格 右 側 的 窗 格

標 記 ’+’ 和 ’-’ 可 以 後 跟 一 個 偏 移 量 ， 例 如 ：

select-window -t:+2

此 外 ， 目 標 會 話 、 目 標 視 窗 或 目 標 窗 格 可 以 完 全 由 標 記 ’{mouse}’ （ 另 一 種 形 式 為 ’=’ ） 組 成 ， 以 指 定 最 近 滑 鼠 事 件 發 生 的 會 話 、 視 窗 或 窗 格 （ 請 參 見 滑 鼠 支 援 部 分 ） 或 者 由 標 記 ’{marked}’ （ 另 一 種 形 式 為 ’~’ ） 組 成 ， 以 指 定 已 標 記 的 窗 格 （ 請 參 見 select-pane -m ） 。

會 話 、 視 窗 和 窗 格 都 有 一 個 唯 一 的 代 號 ； 會 話 代 號 字 首 為 ’$’ ， 視 窗 字 首 為 ’@’ ， 窗 格 字 首 為 ’%’ 。 它 們 是 唯 一 的 ， 並 在 tmux 伺 服 器 中 的 會 話 、 視 窗 或 窗 格 的 生 命 週 期 內 保 持 不 變 。 窗 格 代 號 透 過 TMUX_PANE 環 境 變 數 傳 遞 給 窗 格 的 子 程 序 。 可 以 使 用 ’會 話 代 號 ’ 、 ’視 窗 代 號 ’ 或 ’窗 格 代 號 ’ 格 式 （ 請 參 見 格 式 部 分 ） 和 display-message 、 list-sessions 、 list-windows 或 list-panes 命 令 顯 示 ID。

外 殼 命 令 引 數 是 sh(1) 命 令 。 這 可 以 是 傳 遞 給 外 殼 的 單 個 引 數 ， 例 如 ：

new-window ’vi ~/.tmux.conf’

將 執 行 ：

/bin/sh -c ’vi ~/.tmux.conf’

此 外 ， new-window 、 new-session 、 split-window 、 respawn-window 和 respawn-pane 命 令 允 許 將 外 殼 命 令 作 為 多 個 參 數 給 出 並 直 接 執 行 （ 不 需 要 ’sh -c’ ） 。 這 可 以 避 免 shell 引 號 問 題 。 例 如 ：

$ tmux new-window vi ~/.tmux.conf

將 直 接 執 行 vi(1) 而 不 呼 叫 shell。

命 令 [引 數 ] 指 的 是 一 個 tmux 命 令 ， 可 以 將 命 令 和 引 數 分 開 傳 遞 ， 例 如 ：

bind-key F1 set-option status off

或 在 .tmux.conf 中 作 為 單 個 字 串 引 數 傳 遞 ， 例 如 ：

bind-key F1 { set-option status off }

tmux 命 令 示 例 包 括 ：

refresh-client -t/dev/ttyp2

rename-session -tfirst newname

set-option -wt:0 monitor-activity on

new-window ; split-window -d

bind-key R source-file ~/.tmux.conf \; \

或 者 從 sh(1) ：

$ tmux kill-window -t :1

$ tmux new-window \; split-window -d

$ tmux new-session -d ’vi ~/.tmux.conf’ \; split-window -d \; attach

客 戶 端 和 會 話

tmux 伺 服 器 管 理 客 戶 端 、 會 話 、 視 窗 和 窗 格 。 客 戶 端 附 加 到 會 話 以 與 其 互 動 ， 可 以 使 用 new-session 命 令 建 立 會 話 ， 也 可 以 使 用 attach-session 命 令 在 稍 後 附 加 到 會 話 。 每 個 會 話 有 一 個 或 多 個 視 窗 連 結 到 其 中 。 視 窗 可 以 連 結 到 多 個 會 話 ， 並 由 一 個 或 多 個 窗 格 組 成 ， 每 個 窗 格 包 含 一 個 偽 終 端 。 建 立 、 連 結 和 其 他 操 作 窗 口 的 命 令 在 視 窗 和 窗 格 部 分 中 介 紹 。

以 下 命 令 可 用 於 管 理 客 戶 端 和 會 話 ：

attach-session [-dErx] [-c 工 作 目 錄 ] [-f 符 號 ] [-t 目 標 會 話 ]

(別 名 ： Ic attach)

如 果 在 tmux 之 外 執 行 ， 則 在 當 前 終 端 中 建 立 一 個 新 客 戶 端 並 將 其 附 加 到 目 標 會 話 。 如 果 從 內 部 使 用 ， 則 切 換 當 前 客 戶 端 。 如 果 指 定 了 -d ， 則 會 將 連 線 到 該 會 話 的 任 何 其 他 客 戶 端 斷 開 連 線 。 如 果 給 出 了 -x ， 則 會 將 客 戶 端 分 離 並 向 其 父 進 程 傳 送 SIGHUP 訊 號 ， 通 常 導 致 其 退 出 。 -f 設 定 一 個 逗 號 分 隔 的 客 戶 端 標 誌 列 表 。 這 些 標 誌 包 括 ：

active-pane

客 戶 端 有 一 個 獨 立 的 活 動 窗 格

ignore-size

客 戶 端 不 影 響 其 他 客 戶 端 的 大 小

no-output

客 戶 端 在 控 制 模 式 下 不 接 收 窗 格 輸 出

pause-after=seconds

在 控 制 模 式 下 ， 一 旦 窗 格 落 後 於 seconds 秒 ， 輸 出 就 會 暫 停

read-only

客 戶 端 是 隻 讀 的

wait-exit

在 退 出 控 制 模 式 之 前 等 待 空 行 輸 入

如 果 客 戶 端 已 經 附 加 ， 則 前 導 的 ’!’ 關 閉 標 誌 。 -r 是 -f read-only,ignore-size 的 別 名 。 當 客 戶 端 為 只 讀 時 ， 只 有 繫 結 到 detach-client 或 switch-client 命 令 的 按 鍵 才 會 生 效 。 具 有 active-pane 標 誌 的 客 戶 端 允 許 獨 立 選 擇 活 動 窗 格 ， 而 不 受 未 使 用 該 標 誌 的 客 戶 端 使 用 的 視 窗 活 動 面 板 的 影 響 。 這 僅 影 響 游 標 位 置 和 客 戶 端 發 出 的 命 令 ； 其 他 功 能 （ 例 如 鉤 子 和 樣 式 ） 仍 然 使 用 視 窗 的 活 動 窗 格 。

如 果 沒 有 啟 動 伺 服 器 ， attach-session 將 嘗 試 啟 動 伺 服 器 ； 這 將 失 敗 ， 除 非 在 配 置 檔 案 中 建 立 了 會 話 。

attach-session 的 目 標 會 話 規 則 略 有 調 整 ： 如 果 tmux 需 要 選 擇 最 近 使 用 的 會 話 ， 則 它 將 優 先 選 擇 最 近 使 用 的 未 附 加 會 話 。

-c 將 設 定 會 話 的 工 作 目 錄 （ 用 於 新 視 窗 ） 為 工 作 目 錄 。

如 果 使 用 了 -E ， update-environment 選 項 將 不 會 生 效 。

detach-client [-aP] [-E 外 殼 命 令 ] [-s 目 標 會 話 ] [-t 目 標 客 戶 端 ]

(別 名 ： Ic detach)

分 離 當 前 繫 結 到 鍵 、 使 用 -t 指 定 的 客 戶 端 或 者 所 有 當 前 連 線 到 -s 指 定 的 會 話 的 客 戶 端 。 -a 選 項 會 殺 死 除 了 使 用 -t 指 定 的 客 戶 端 之 外 的 所 有 客 戶 端 。 如 果 指 定 了 -P ， 會 向 客 戶 端 的 父 程 序 傳 送 SIGHUP 訊 號 ， 通 常 導 致 其 退 出 。 使 用 -E ， 執 行 外 殼 命 令 來 替 換 客 戶 端 。

has-session [-t target-session]

(別 名 ： Ic has)

如 果 指 定 的 會 話 不 存 在 ， 則 報 告 錯 誤 並 以 1 退 出 。 如 果 該 會 話 存 在 ， 則 以 0 退 出 。

kill-server

殺 死 tmux 伺 服 器 和 客 戶 端 ， 並 銷 燬 所 有 會 話 。

kill-session [-aC] [-t 目 標 會 話 ]

銷 燬 給 定 會 話 ， 關 閉 與 之 關 聯 的 所 有 視 窗 ， 並 斷 開 所 有 連 線 到 該 會 話 的 客 戶 端 。 如 果 指 定 了 -a ， 則 除 指 定 的 會 話 外 ， 所 有 會 話 都 會 被 銷 燬 。 -C 標 誌 會 清 除 與 會 話 關 聯 的 所 有 視 窗 中 的 提 示 （ 響 鈴 、 活 動 或 靜 音 ） 。

list-clients [-F 格 式 ] [-t 目 標 會 話 ]

(別 名 ： Ic lsc)

列 出 所 有 連 線 到 伺 服 器 的 客 戶 端 。 有 關 -F 標 誌 的 含 義 ， 請 參 見 格 式 部 分 。 如 果 指 定 了 目 標 會 話 ， 則 僅 列 出 連 線 到 該 會 話 的 客 戶 端 。

list-commands [-F 格 式 ] [命 令 ]

(別 名 ： Ic lscm)

列 出 命 令 的 語 法 ， 如 果 省 略 ， 則 列 出 tmux 支 援 的 所 有 命 令 的 語 法 。

list-sessions [-F 格 式 ] [-f 過 濾 器 ]

(別 名 ： Ic ls)

列 出 伺 服 器 管 理 的 所 有 會 話 。 -F 指 定 每 行 的 格 式 ， -f 指 定 一 個 過 濾 器 。 僅 顯 示 過 濾 器 為 真 的 會 話 。 有 關 詳 細 資 訊 ， 請 參 見 格 式 部 分 。

lock-client [-t 目 標 客 戶 端 ]

(別 名 ： Ic lockc)

鎖 定 target-client ， 請 參 見 lock-server 命 令 。

lock-session [-t 目 標 會 話 ]

(別 名 ： Ic locks)

鎖 定 連 線 到 目 標 會 話 的 所 有 客 戶 端 。

new-session [-AdDEPX] [-c 起 始 目 錄 ] [-e 環 境 ] [-f 符 號 ] [-F 格 式 ] [-n 視 窗 名 稱 ] [-s 會 話 名 稱 ] [-t 組 名 ] [-x 寬 度 ] [-y 高 度 ] [外 殼 命 令 ]

(別 名 ： Ic new)

建 立 一 個 名 為 會 話 名 稱 的 新 會 話 。

除 非 指 定 了 -d ， 否 則 新 會 話 將 連 線 到 當 前 終 端 。 視 窗 名 稱 和 外 殼 命 令 分 別 是 初 始 視 窗 的 名 稱 和 要 執 行 的 shell 命 令 。 使 用 -d ， 初 始 大 小 來 自 全 域 性 的 default-size 選 項 ； -x 和 -y 可 用 於 指 定 不 同 的 大 小 。 ’-’ 使 用 當 前 客 戶 端 （ 如 果 有 ） 的 大 小 。 如 果 給 出 了 -x 或 -y ， 則 會 為 該 會 話 設 定 default-size 選 項 。 -f 設 定 一 個 逗 號 分 隔 的 客 戶 端 標 誌 列 表 （ 參 見 attach-session ） 。

如 果 從 終 端 執 行 ， 則 會 儲 存 並 在 新 會 話 的 新 視 窗 中 使 用 任 何 termios(4) 特 殊 字 符 。

如 果 會 話 名 稱 已 經 存 在 ， 則 -A 標 誌 使 new-session 的 行 為 類 似 於 attach-session ； 在 這 種 情 況 下 ， -D 的 行 為 類 似 於 attach-session 的 -d ， -X 的 行 為 類 似 於 attach-session 的 -x 。

如 果 給 定 了 -t ， 則 它 指 定 了 一 個 會 話 組 。 同 一 組 中 的 會 話 共 享 相 同 的 窗 口 集 - 新 視 窗 連 結 到 組 中 的 所 有 會 話 ， 並 從 所 有 會 話 中 刪 除 任 何 關 閉 的 視 窗 。 當 前 和 前 一 個 視 窗 以 及 任 何 會 話 選 項 保 持 獨 立 ， 組 中 的 任 何 會 話 都 可 以 被 殺 死 而 不 影 響 其 他 會 話 。 組 名 引 數 可 以 是 以 下 內 容 之 一 ：

1.

現 有 組 的 名 稱 ， 此 時 新 會 話 將 新 增 到 該 組 中 ；

2.

現 有 會 話 的 名 稱 - 新 會 話 將 新 增 到 與 該 會 話 相 同 的 組 中 ， 必 要 時 建 立 新 組 ；

3.

僅 包 含 新 會 話 的 新 組 的 名 稱 。

-t 如 果 被 使 用 ， -n 和 外 殼 命 令 是 無 效 的 。

-P 選 項 在 建 立 新 會 話 後 列 印 有 關 該 會 話 的 資 訊 。 預 設 情 況 下 ， 它 使 用 格 式 ’#{session_name}:’ ， 但 可 以 使 用 -F 指 定 不 同 的 格 式 。

如 果 使 用 -E ， 則 不 會 應 用 update-environment 選 項 。 -e 的 形 式 為 ’VARIABLE=value’ ， 用 於 為 新 建 立 的 會 話 設 定 環 境 變 數 ； 可 以 多 次 指 定 。

refresh-client [-cDLRSU] [-A 窗 格 :狀 態 ] [-B 名 稱 :什 麼 :格 式 ] [-C 尺 寸 ] [-f 符 號 ] [-l [目 標 窗 格 ]] [-t 目 標 客 戶 端 ] [adjustment]

(別 名 ： Ic refresh)

如 果 繫 結 到 鍵 ， 則 重 新 整 理 當 前 客 戶 端 ； 如 果 使 用 -t 指 定 了 一 個 客 戶 端 ， 則 重 新 整 理 單 個 客 戶 端 。 如 果 指 定 了 -S ， 則 只 更 新 客 戶 端 的 狀 態 列 。

-U 、 -D 、 -L 、 -R 和 -c 標 誌 允 許 更 改 大 於 客 戶 端 的 窗 口 的 可 見 部 分 。 -U 將 可 見 部 分 向 上 移 動 adjustment 行 ， -D 向 下 移 動 ， -L 將 其 向 左 移 動 adjustment 列 ， -R 向 右 移 動 。 -c 返 回 自 動 跟 蹤 游 標 。 如 果 省 略 adjustment ， 則 使 用 1。 請 注 意 ， 可 見 位 置 是 客 戶 端 的 屬 性 ， 而 不 是 視 窗 的 屬 性 ， 在 連 線 的 會 話 中 更 改 當 前 視 窗 將 重 置 它 。

-C 設 定 控 制 模 式 客 戶 端 的 寬 度 和 高 度 ， 或 者 設 定 控 制 模 式 客 戶 端 視 窗 的 寬 度 和 高 度 。 尺 寸 必 須 是 ’寬 度 x高 度 ’ 或 ’視 窗 代 號 :寬 度 x高 度 ’ 之 一 ， 例 如 ’80x24’ 或 ’@0:80x24’ 。 -A 允 許 控 制 模 式 客 戶 端 觸 發 對 窗 格 的 操 作 。 引 數 是 窗 格 ID（ 帶 前 導 ’%’ ） ， 一 個 冒 號 ， 然 後 是 ’on’ 、 ’off’ 、 ’continue’ 或 ’pause’ 中 的 一 個 。 如 果 是 ’off’ ， 則 tmux 不 會 將 窗 格 的 輸 出 傳 送 到 客 戶 端 ， 如 果 所 有 客 戶 端 都 將 窗 格 關 閉 ， 則 停 止 從 窗 格 讀 取 。 如 果 是 ’continue’ ， 則 如 果 窗 格 已 暫 停 （ 手 動 或 使 用 pause-after 標 志 ） ， tmux 將 返 回 將 輸 出 傳 送 到 窗 格 。 如 果 是 ’pause’ ， tmux 將 暫 停 窗 格 。 -A 可 以 針 對 不 同 的 窗 格 多 次 使 用 。

-B 設 定 控 制 模 式 客 戶 端 的 格 式 訂 閱 。 引 數 由 冒 號 分 成 三 個 專 案 ： name 是 訂 閱 的 名 稱 ； what 是 要 訂 閱 的 專 案 型 別 ； format 是 格 式 。 新 增 訂 閱 後 ， 格 式 更 改 會 使 用 %subscription-changed 通 知 報 告 ， 最 多 每 秒 一 次 。 如 果 只 提 供 名 稱 ， 則 取 消 訂 閱 。 what 可 以 為 空 ， 僅 檢 查 已 連 線 會 話 的 格 式 ， 或 者 為 以 下 之 一 ： 窗 格 ID（ 如 ’%0’ ） ； 所 有 連 線 會 話 中 的 所 有 窗 格 ， 例 如 ’%’ ； 視 窗 ID（ 如 ’@0’ ） ； 或 所 有 連 線 會 話 中 的 所 有 視 窗 ， 例 如 ’@’ 。

-f 設 定 逗 號 分 隔 的 客 戶 端 標 誌 列 表 ， 參 見 attach-session 。

-l 使 用 xterm(1) 轉 義 序 列 從 客 戶 端 請 求 剪 貼 簿 。 如 果 給 定 了 Ar target-pane， 則 剪 貼 簿 將 被 髮 送 （ 以 編 碼 形 式 ） ， 否 則 它 將 被 儲 存 在 新 的 貼 上 緩 衝 區 中 。

-L 、 -R 、 -U 和 -D 將 視 窗 的 可 見 部 分 向 左 、 向 右 、 向 上 或 向 下 移 動 adjustment ， 如 果 視 窗 大 於 客 戶 端 的 大 小 。 -c 重 置 ， 以 便 位 置 跟 隨 游 標 。 請 參 見 window-size 選 項 。

rename-session [-t 目 標 會 話 ] 新 名 稱

(別 名 ： Ic rename)

將 會 話 重 新 命 名 為 新 名 稱 .

server-access [-adlrw] [user]

更 改 user 的 訪 問 或 讀 寫 許 可 權 。 運 行 tmux 伺 服 器 的 使 用 者 （ 其 所 有 者 ） 和 root 使 用 者 無 法 更 改 ， 並 且 始 終 被 允 許 訪 問 。

-a 和 -d 用 於 授 予 或 撤 銷 指 定 使 用 者 的 訪 問 許 可 權 。 如 果 使 用 者 已 連 線 ， -d 標 誌 會 導 致 其 客 戶 端 被 分 離 。

-r 和 -w 更 改 user 的 許 可 權 ： -r 使 其 客 戶 端 只 讀 ， 而 -w 使 其 可 寫 。 -l 列 出 當 前 的 訪 問 許 可 權 。

預 設 情 況 下 ， 訪 問 列 表 為 空 ， tmux 使 用 檔 案 系 統 許 可 權 建 立 套 接 字 ， 防 止 任 何 使 用 者 （ 除 了 所 有 者 和 root） 訪 問 。 這 些 許 可 權 必 須 手 動 更 改 。 不 應 該 允 許 不 受 信 任 的 使 用 者 訪 問 ， 即 使 是 隻 讀 訪 問 也 應 該 格 外 小 心 。

show-messages [-JT] [-t 目 標 客 戶 端 ]

(別 名 ： Ic showmsgs)

顯 示 伺 服 器 訊 息 或 資 訊 。 訊 息 會 被 儲 存 ， 最 多 儲 存 數 量 由 訊 息 限 制 伺 服 器 選 項 設 定 的 限 制 。 -J 和 -T 顯 示 有 關 作 業 和 終 端 的 除 錯 資 訊 。

source-file [-Fnqv] 路 徑 ...

(別 名 ： Ic source)

從 由 路 徑 （ 可 以 是 glob(7) 模 式 ） 指 定 的 一 個 或 多 個 檔 案 中 執 行 命 令 。 如 果 存 在 -F ， 則 路 徑 會 被 展 開 為 格 式 。 如 果 給 定 了 -q ， 則 如 果 路 徑 不 存 在 ， 不 會 返 回 錯 誤 。 使 用 -n ， 可 以 解 析 檔 案 ， 但 不 會 執 行 任 何 命 令 。 如 果 可 能 ， -v 顯 示 解 析 的 命 令 和 行 號 。

start-server

(別 名 ： Ic start)

如 果 尚 未 執 行 ， 則 啟 動 tmux 伺 服 器 ， 但 不 建 立 任 何 會 話 。

請 注 意 ， 預 設 情 況 下 ， tmux 伺 服 器 將 以 沒 有 會 話 的 方 式 退 出 ， 因 此 僅 當 在 ~/.tmux.conf 中 建 立 會 話 、 關 閉 exit-empty 或 作 為 同 一 命 令 序 列 的 一 部 分 執 行 另 一 個 命 令 時 ， 此 選 項 才 有 用 。 例 如 ：

$ tmux start \; show -g

suspend-client [-t 目 標 客 戶 端 ]

(別 名 ： Ic suspendc)

透 過 傳 送 SIGTSTP （ 終 端 停 止 ） 來 掛 起 客 戶 端 。

switch-client [-ElnprZ] [-c 目 標 客 戶 端 ] [-t 目 標 會 話 ] [-T 快 捷 鍵 表 ]

(別 名 ： Ic switchc)

將 客 戶 端 目 標 客 戶 端 的 當 前 會 話 切 換 到 目 標 會 話 。 作 為 一 種 特 殊 情 況 ， -t 可 能 會 引 用 一 個 窗 格 （ 包 含 ’:’ 、 ’.’ 或 ’%’) ， 以 更 改 會 話 、 視 窗 和 窗 格 。 在 這 種 情 況 下 ， 如 果 視 窗 已 經 被 放 大 ， -Z 將 保 持 視 窗 放 大 。 如 果 使 用 了 -l 、 -n 或 -p ， 則 將 客 戶 端 分 別 移 動 到 最 後 、 下 一 個 或 上 一 個 會 話 。 -r 切 換 客 戶 端 的 只 讀 和 ignore-size 標 志 （ 請 參 見 attach-session 命 令 ） 。

如 果 使 用 了 -E ， 則 update-environment 選 項 將 不 會 應 用 。

-T 設 定 客 戶 端 的 鍵 表 ； 下 一 個 鍵 將 從 快 捷 鍵 表 解 釋 。 這 可 用 於 配 置 多 個 字 首 鍵 ， 或 將 命 令 繫 結 到 鍵 序 列 。 例 如 ， 要 使 鍵 入 ’abc’ 執 行 list-keys 命 令 ：

bind-key -Ttable2 c list-keys
bind-key -Ttable1 b switch-client -Ttable2
bind-key -Troot a switch-client -Ttable1

視 窗 和 窗 格

tmux 顯 示 的 每 個 視 窗 都 可 以 分 成 一 個 或 多 個 窗 格 ； 每 個 窗 格 佔 據 顯 示 區 域 的 一 定 部 分 ， 是 一 個 獨 立 的 終 端 。 可 以 使 用 split-window 命 令 將 視 窗 分 成 窗 格 。 可 以 水 平 （ 使 用 -h 標 誌 ） 或 垂 直 地 分 割 視 窗 。 可 以 使 用 resize-pane 命 令 （ 預 設 情 況 下 繫 結 到 ’C-Up’ 、 ’C-Down’ 、 ’C-Left’ 和 ’C-Right’ ） 來 調 整 窗 格 的 大 小 ， 可 以 使 用 select-pane 命 令 更 改 當 前 窗 格 ， 並 可 以 使 用 rotate-window 和 swap-pane 命 令 交 換 窗 格 而 不 改 變 其 位 置 。 窗 格 按 它 們 建 立 的 順 序 從 零 開 始 編 號 。

預 設 情 況 下 ， tmux 窗 格 允 許 直 接 訪 問 包 含 在 窗 格 中 的 終 端 。 窗 格 也 可 以 被 放 入 多 種 模 式 之 一 ：

-

複 製 模 式 ， 允 許 將 視 窗 的 一 部 分 或 歷 史 記 錄 複 製 到 貼 上 緩 衝 區 中 ， 以 便 稍 後 插 入 到 另 一 個 視 窗 中 。 使 用 copy-mode 命 令 （ 預 設 繫 結 到 ’[’ ） 進 入 此 模 式 。 可 以 使 用 paste-buffer 命 令 （ 繫 結 到 ’]’ ） 將 複 製 的 文 字 粘 貼 。

-

檢 視 模 式 ， 類 似 於 複 製 模 式 ， 但 在 從 鍵 繫 結 執 行 產 生 輸 出 的 命 令 （ 例 如 list-keys ） 時 進 入 此 模 式 。

-

選 擇 模 式 ， 允 許 從 列 表 中 選 擇 一 個 專 案 。 這 可 以 是 客 戶 端 、 會 話 或 視 窗 或 窗 格 ， 也 可 以 是 緩 衝 區 。 使 用 choose-buffer 、 choose-client 和 choose-tree 命 令 進 入 此 模 式 。

在 複 製 模 式 下 ， 窗 格 右 上 角 會 顯 示 當 前 位 置 和 歷 史 記 錄 中 行 數 的 指 示 器 。

使 用 -X 標 誌 將 命 令 傳 送 到 複 製 模 式 的 send-keys 命 令 。 按 下 鍵 時 ， 復 制 模 式 會 自 動 使 用 兩 個 鍵 表 中 的 一 個 ， 具 體 取 決 於 mode-keys 選 項 ： 對 於 Emacs， 使 用 copy-mode ， 對 於 vi 使 用 copy-mode-vi 。 可 以 使 用 list-keys 命 令 檢 視 鍵 表 。

複 製 模 式 支 援 以 下 命 令 ：

命 令 vi emacs
append-selection
append-selection-and-cancel A
back-to-indentation ^ M-m
begin-selection Space C-Space
bottom-line L
cancel q Escape
clear-selection Escape C-g
copy-end-of-line [<prefix>]
copy-end-of-line-and-cancel [<prefix>]
copy-pipe-end-of-line [<command>] [<prefix>]
copy-pipe-end-of-line-and-cancel [<command>] [<prefix>] D C-k
copy-line [<prefix>]
copy-line-and-cancel [<prefix>]
copy-pipe-line [<command>] [<prefix>]
copy-pipe-line-and-cancel [<command>] [<prefix>]
copy-pipe [<command>] [<prefix>]
copy-pipe-no-clear [<command>] [<prefix>]
copy-pipe-and-cancel [<command>] [<prefix>]
copy-selection [<prefix>]
copy-selection-no-clear [<prefix>]
copy-selection-and-cancel [<prefix>] Enter M-w
cursor-down j Down
cursor-down-and-cancel
cursor-left h Left
cursor-right l Right
cursor-up k Up
end-of-line $ C-e
goto-line <line> : g
halfpage-down C-d M-Down
halfpage-down-and-cancel
halfpage-up C-u M-Up
history-bottom G M->
history-top g M-<
jump-again ; ;
jump-backward <to> F F
jump-forward <to> f f
jump-reverse , ,
jump-to-backward <to> T
jump-to-forward <to> t
jump-to-mark M-x M-x
middle-line M M-r
next-matching-bracket % M-C-f
next-paragraph } M-}
next-space W
next-space-end E
next-word w
next-word-end e M-f
other-end o
page-down C-f PageDown
page-down-and-cancel
page-up C-b PageUp
pipe [<command>] [<prefix>]
pipe-no-clear [<command>] [<prefix>]
pipe-and-cancel [<command>] [<prefix>]
previous-matching-bracket M-C-b
previous-paragraph { M-{
previous-space B
previous-word b M-b
rectangle-on
rectangle-off
rectangle-toggle v R
refresh-from-pane r r
scroll-down C-e C-Down
scroll-down-and-cancel
scroll-up C-y C-Up
search-again n n
search-backward <for> ?
search-backward-incremental <for> C-r
search-backward-text <for>
search-forward <for> /
search-forward-incremental <for> C-s
search-forward-text <for>
search-reverse N N
select-line V
select-word
set-mark X X
start-of-line 0 C-a
stop-selection
toggle-position P P
top-line H M-R

搜 尋 命 令 有 幾 個 不 同 的 變 體 ： ’search-forward’ 和 ’search-backward’ 搜 索 正 則 表 示 式 ； ’-text’ 變 體 搜 尋 普 通 文 字 字 串 而 不 是 正 則 表 示 式 ； ’-incremental’ 執 行 增 量 搜 尋 ， 並 帶 有 -i 標 誌 用 於 command-prompt 命 令 。 ’search-again’ 重 複 上 次 搜 尋 ， 而 ’search-reverse’ 則 相 同 ， 但 反 轉 方 向 （ 向 前 變 為 向 後 ， 向 後 變 為 向 前 ） 。

複 製 命 令 可 能 帶 有 一 個 可 選 的 緩 衝 區 字 首 引 數 ， 用 於 生 成 緩 衝 區 名 稱 （ 預 設 為 ’buffer’ ， 因 此 緩 衝 區 的 名 稱 為 ’buffer0’ 、 ’buffer1’ 等 ） 。 管 道 命 令 帶 有 一 個 命 令 引 數 ， 該 引 數 是 選 定 文 字 要 輸 送 到 的 命 令 。 ’copy-pipe’ 變 體 還 會 複 製 所 選 內 容 。 某 些 命 令 的 ’-and-cancel’ 變 體 在 完 成 後 （ 對 於 複 製 命 令 ） 或 游 標 到 達 底 部 （ 對 於 滾 動 命 令 ） 後 退 出 複 製 模 式 。 ’-no-clear’ 變 體 不 清 除 所 選 內 容 。

下 一 個 和 前 一 個 單 詞 鍵 跳 過 空 格 ， 並 將 連 續 的 單 詞 分 隔 符 或 其 他 字 母 序 列 視 為 單 詞 。 可 以 使 用 word-separators 會 話 選 項 自 定 義 單 詞 分 隔 符 。 下 一 個 單 詞 移 動 到 下 一 個 單 詞 的 開 頭 ， 下 一 個 單 詞 結 束 移 動 到 下 一 個 單 詞 的 結 尾 ， 而 前 一 個 單 詞 移 動 到 前 一 個 單 詞 的 開 頭 。 三 個 下 一 個 和 前 一 個 空 格 鍵 的 工 作 方 式 類 似 ， 但 僅 使 用 空 格 作 為 單 詞 分 隔 符 。 將 word-separators 設 定 為 空 字 串 將 使 下 一 個 /前 一 個 單 詞 等 同 於 下 一 個 /前 一 個 空 格 。

跳 轉 命 令 可 以 快 速 移 動 到 行 內 。 例 如 ， 鍵 入 ’f’ ， 然 後 跟 隨 ’/’ ， 將 游 標 移 動 到 當 前 行 上 的 下 一 個 ’/’ 字 元 。 然 後 ， 使 用 ’;’ 可 以 跳 轉 到 下 一 個 匹 配 項 。

在 複 製 模 式 下 的 命 令 可 以 在 前 面 加 上 可 選 的 重 複 計 數 。 使 用 vi 鍵 繫 結 時 ， 字 首 使 用 數 字 鍵 輸 入 ； 使 用 emacs 鍵 繫 結 時 ， Alt（ meta） 鍵 和 數 字 開 始 輸 入 字 首 。

copy-mode 命 令 的 概 要 為 ：

copy-mode [-eHMqu] [-s src-pane] [-t target-pane]

進 入 複 製 模 式 。 -u 選 項 向 上 滾 動 一 頁 。 -M 開 始 滑 鼠 拖 動 （ 僅 在 繫 結 到 滑 鼠 鍵 繫 結 時 有 效 ， 請 參 閱 MOUSE SUPPORT ） 。 -H 隱 藏 右 上 角 的 位 置 指 示 器 。 -q 取 消 複 製 模 式 和 任 何 其 他 模 式 。 -s 從 src-pane 而 不 是 從 target-pane 複 製 。

-e 指 定 滾 動 到 歷 史 記 錄 底 部 （ 到 可 見 螢 幕 ） 應 退 出 複 製 模 式 。 在 複 製 模 式 下 ， 按 下 用 於 滾 動 以 外 的 鍵 將 禁 用 此 行 為 。 這 旨 在 允 許 快 速 滾 動 窗 格 的 歷 史 記 錄 ， 例 如 ：

bind PageUp copy-mode -eu

有 許 多 預 設 的 窗 格 排 列 方 案 可 用 ， 稱 為 佈 局 。 可 以 使 用 select-layout 命 令 選 擇 這 些 佈 局 ， 也 可 以 使 用 next-layout （ 預 設 繫 結 到 ’Space’ ） 進 行 循 環 ； 選 擇 佈 局 後 ， 其 中 的 窗 格 可 以 像 平 常 一 樣 移 動 和 調 整 大 小 。

支 援 以 下 佈 局 ：

even-horizontal

窗 格 在 視 窗 上 從 左 到 右 均 勻 分 佈 。

even-vertical

窗 格 從 上 到 下 均 勻 分 佈 。

main-horizontal

一 個 大 的 （ 主 要 ） 窗 格 顯 示 在 視 窗 頂 部 ， 其 餘 的 窗 格 從 左 到 右 分 佈 在 底 部 的 剩 餘 空 間 中 。 使 用 main-pane-height 視 窗 選 項 指 定 頂 部 窗 格 的 高 度 。

main-vertical

類 似 於 main-horizontal ， 但 大 窗 格 放 置 在 左 側 ， 其 餘 窗 格 從 上 到 下 沿 右 側 分 布 。 請 參 閱 main-pane-width 視 窗 選 項 。

tiled

窗 格 儘 可 能 均 勻 地 分 佈 在 視 窗 的 行 和 列 中 。

此 外 ， select-layout 可 用 於 應 用 先 前 使 用 的 佈 局 - list-windows 命 令 以 適 合 與 select-layout 使 用 的 形 式 顯 示 每 個 視 窗 的 佈 局 。 例 如 ：

$ tmux list-windows
0: ksh [159x48]
layout: bb62,159x48,0,0{79x48,0,0,79x48,80,0}
$ tmux select-layout ’bb62,159x48,0,0{79x48,0,0,79x48,80,0}’

tmux 自 動 調 整 當 前 視 窗 大 小 的 佈 局 大 小 。 請 注 意 ， 不 能 將 佈 局 應 用 於 視 窗 中 的 窗 格 數 量 超 過 原 始 定 義 佈 局 的 視 窗 。

與 視 窗 和 窗 格 相 關 的 命 令 如 下 ：

break-pane [-abdP] [-F 格 式 ] [-n 視 窗 名 稱 ] [-s 源 窗 格 ] [-t 目 標 視 窗 ]

(別 名 ： Ic breakp)

將 源 窗 格 從 其 所 在 的 視 窗 中 分 離 出 來 ， 使 其 成 為 目 標 視 窗 中 唯 一 的 窗 格 。 使 用 -a 或 -b ， 視 窗 將 移 動 到 當 前 索 引 的 下 一 個 或 前 一 個 位 置 （ 必 要 時 移 動 現 有 視 窗 ） 。 如 果 給 出 -d ， 新 視 窗 不 會 成 為 當 前 視 窗 。 -P 選 項 在 建 立 新 視 窗 後 列 印 有 關 新 視 窗 的 資 訊 。 預 設 情 況 下 ， 它 使 用 格 式 ’#{session_name}:#{window_index}.#{pane_index}’ ， 但 可 以 使 用 -F 指 定 不 同 的 格 式 。

capture-pane [-aAepPqCJN] [-b 緩 衝 區 名 稱 ] [-E 結 束 行 ] [-S 起 始 行 ] [-t 目 標 窗 格 ]

(別 名 ： Ic capturep)

捕 獲 窗 格 的 內 容 。 如 果 給 出 -p ， 則 輸 出 將 傳 送 到 標 準 輸 出 ， 否 則 將 傳 送 到 使 用 -b 指 定 的 緩 衝 區 ， 如 果 省 略 則 傳 送 到 新 緩 衝 區 。 如 果 給 出 -a ， 則 使 用 備 用 螢 幕 ， 歷 史 記 錄 不 可 訪 問 。 如 果 不 存 在 備 用 螢 幕 ， 則 會 返 回 錯 誤 ， 除 非 給 出 -q 。 如 果 給 出 -e ， 則 輸 出 包 括 文 字 和 背 景 屬 性 的 轉 義 序 列 。 -C 還 將 非 可 列 印 字 元 轉 義 為 八 進 位 制 \xxx。 -N 保 留 每 行 末 尾 的 尾 隨 空 格 ， -J 保 留 尾 隨 空 格 並 連 線 任 何 換 行 的 行 。 -P 僅 捕 獲 窗 格 已 接 收 但 尚 未 完 整 的 轉 義 序 列 開 頭 的 任 何 輸 出 。

-S 和 -E 指 定 起 始 和 結 束 行 號 ， 0 是 可 見 窗 格 的 第 一 行 ， 負 數 是 歷 史 記 錄 中 的 行 。 ’-’ 到 -S 是 歷 史 記 錄 的 開 頭 ， 到 -E 是 可 見 窗 格 的 末 尾 。 預 設 情 況 下 ， 僅 捕 獲 窗 格 的 可 見 內 容 。

choose-client [-NrZ] [-F 格 式 ] [-f 過 濾 器 ] [-K 快 捷 鍵 格 式 ] [-O 排 序 ] [-t 目 標 窗 格 ] [模 板 ]

將 窗 格 置 於 客 戶 端 模 式 ， 允 許 從 列 表 中 互 動 式 地 選 擇 客 戶 端 。 每 個 客 戶 端 顯 示 在 一 行 上 。 快 捷 鍵 顯 示 在 左 側 的 括 號 中 ， 允 許 進 行 立 即 選 擇 ， 或 者 可 以 使 用 下 面 的 鍵 導 航 列 表 並 選 擇 或 以 其 他 方 式 操 作 專 案 。 -Z 縮 放 窗 格 。 可 以 在 客 戶 端 模 式 下 使 用 以 下 鍵 ：

選 擇 客 戶 端 後 ， ’%%’ 在 template 中 被 客 戶 端 名 稱 替 換 ， 並 將 結 果 執 行 為 命 令 。 如 果 未 給 出 template ， 則 使 用 "detach-client -t ’%%’"。

-O 指 定 初 始 排 序 欄 位 ： 為 ’name’ 、 ’size’ 、 ’creation’ 或 ’activity’ 中 的 一 個 。 -r 反 轉 排 序 順 序 。 -f 指 定 初 始 過 濾 器 ： 過 濾 器 是 一 個 格 式 - 如 果 它 評 估 為 零 ， 則 不 顯 示 列 表 中 的 專 案 ， 否 則 顯 示 它 。 如 果 過 濾 器 會 導 致 空 列 表 ， 則 它 將 被 忽 略 。 -F 指 定 列 表 中 每 個 專 案 的 格 式 ， -K 指 定 每 個 快 捷 鍵 的 格 式 ； 兩 者 都 會 為 每 行 評 估 一 次 。 -N 在 沒 有 預 覽 的 情 況 下 啟 動 。 僅 當 至 少 有 一 個 客 戶 端 附 加 時 ， 此 命 令 才 有 效 。

choose-tree [-GNrswZ] [-F format] [-f filter] [-K key-format] [-O sort-order] [-t target-pane] [template]

將 窗 格 置 於 樹 模 式 ， 允 許 從 樹 中 互 動 式 地 選 擇 會 話 、 視 窗 或 窗 格 。 每 個 會 話 、 視 窗 或 窗 格 顯 示 在 一 行 上 。 快 捷 鍵 顯 示 在 左 側 的 括 號 中 ， 允 許 進 行 立 即 選 擇 ， 或 者 可 以 使 用 下 面 的 鍵 導 航 樹 並 選 擇 或 以 其 他 方 式 操 作 專 案 。 -s 以 會 話 摺 疊 開 始 ， -w 以 視 窗 摺 疊 開 始 。 -Z 縮 放 窗 格 。 可 以 在 樹 模 式 下 使 用 以 下 鍵 ：

選 擇 會 話 、 視 窗 或 窗 格 後 ， ’%%’ 的 第 一 個 例 項 和 所 有 例 項 ’%1’ 在 template 中 被 目 標 替 換 ， 並 將 結 果 執 行 為 命 令 。 如 果 未 給 出 template ， 則 使 用 "switch-client -t ’%%’"。

-O 指 定 了 初 始 排 序 欄 位 ： 可 以 是 ’index’ 、 ’name’ 或 ’time’ 中 的 一 個 。 -r 可 以 反 轉 排 序 順 序 。 -f 指 定 了 一 個 初 始 過 濾 器 ： 該 過 濾 器 是 一 個 格 式 化 字 串 ， 如 果 它 的 值 為 零 ， 則 不 顯 示 列 表 中 的 該 項 ， 否 則 就 會 顯 示 。 如 果 過 濾 器 導 致 列 表 為 空 ， 則 會 被 忽 略 。 -F 指 定 了 樹 中 每 個 專 案 的 格 式 ， -K 指 定 了 每 個 快 捷 鍵 的 格 式 ； 這 兩 個 格 式 化 字 串 將 分 別 對 每 行 進 行 求 值 。 -N 開 始 時 不 顯 示 預 覽 。 -G 包 括 樹 中 所 有 會 話 組 中 的 所 有 會 話 ， 而 不 僅 僅 是 第 一 個 會 話 組 。 該 命 令 僅 在 至 少 有 一 個 客 戶 端 連 線 時 有 效 。

customize-mode [-NZ] [-F 格 式 ] [-f 過 濾 器 ] [-t 目 標 窗 格 ] [模 板 ]

： 將 窗 格 置 於 自 定 義 模 式 ， 可 以 從 列 表 中 瀏 覽 和 修 改 選 項 和 鍵 繫 結 。 該 列 表 中 的 選 項 值 顯 示 為 當 前 視 窗 中 活 動 窗 格 的 值 。 -Z 縮 放 窗 格 。 自 定 義 模 式 下 可 以 使 用 以 下 按 鍵 ：

-f 指 定 了 一 個 初 始 過 濾 器 ： 過 濾 器 是 一 個 格 式 ， 如 果 它 求 值 為 零 ， 則 列 表 中 的 項 目 不 會 顯 示 ， 否 則 會 顯 示 。 如 果 過 濾 器 會 導 致 空 列 表 ， 則 會 被 忽 略 。 -F 指 定 了 樹 中 每 個 專 案 的 格 式 。 -N 開 始 時 不 顯 示 選 項 資 訊 。 此 命 令 僅 在 至 少 有 一 個 客 戶 端 連 接 時 才 起 作 用 。

display-panes [-bN] [-d 持 續 時 間 ] [-t 目 標 客 戶 端 ] [模 板 ]

(別 名 ： Ic displayp)

顯 示 由 target-client 顯 示 的 每 個 窗 格 的 可 見 指 示 器 。 請 參 閱 display-panes-colour 和 display-panes-active-colour 會 話 選 項 。 在 按 下 鍵 （ 除 非 給 出 -N ） 或 持 續 時 間 毫 秒 後 ， 指 示 器 將 關 閉 。 如 果 未 給 出 -d ， 則 使 用 display-panes-time 。 持 續 時 間 為 零 表 示 指 示 器 保 持 到 按 下 鍵 為 止 。 在 指 示 器 在 螢 幕 上 時 ， 可 以 使 用 ’0’ 到 ’9’ 鍵 選 擇 窗 格 ， 這 將 導 致 使 用 ’%%’ 替 換 窗 格 代 號 的 命 令 模 板 被 執 行 。 預 設 的 模 板 是 "select-pane -t ’%%’"。 使 用 -b ， 直 到 指 示 器 關 閉 ， 其 他 命 令 不 會 被 阻 塞 。

find-window [-iCNrTZ] [-t 目 標 窗 格 ] 匹 配 字 串

(別 名 ： Ic findw)

在 視 窗 名 稱 、 標 題 和 可 見 內 容 （ 但 不 包 括 歷 史 記 錄 ） 中 搜 索 fnmatch(3) 模 式 或 帶 有 -r 的 正 則 表 示 式 匹 配 字 串 。 標 誌 控 制 匹 配 行 為 ： -C 僅 匹 配 可 見 視 窗 內 容 ， -N 僅 匹 配 視 窗 名 稱 ， -T 僅 匹 配 視 窗 標 題 。 -i 使 搜 尋 忽 略 大 小 寫 。 預 設 為 -CNT 。 -Z 最 大 化 所 在 窗 格 。

此 命 令 僅 在 至 少 連 線 了 一 個 客 戶 端 時 才 有 效 。

join-pane [-bdfhv] [-l 尺 寸 ] [-s 源 窗 格 ] [-t 目 的 窗 格 ]

(別 名 ： Ic joinp)

類 似 於 split-window ， 但 是 不 是 將 目 的 窗 格 分 割 並 建 立 一 個 新 窗 格 ， 而 是 將 它 分 割 並 將 源 窗 格 移 動 到 該 位 置 。 這 可 用 於 撤 消 break-pane 。 使 用 -b 選 項 將 源 窗 格 加 入 到 目 的 窗 格 的 左 側 或 上 方 。

如 果 省 略 -s ， 並 且 存 在 標 記 的 窗 格 （ 參 見 select-pane -m ） ， 則 使 用 標 記 的 窗 格 而 不 是 當 前 窗 格 。

kill-pane [-a] [-t 目 標 窗 格 ]

(別 名 ： Ic killp)

銷 燬 給 定 的 窗 格 。 如 果 包 含 窗 格 的 視 窗 中 沒 有 窗 格 ， 則 該 視 窗 也 會 被 銷 燬 。 -a 選 項 會 銷 燬 除 使 用 -t 給 出 的 窗 格 之 外 的 所 有 窗 格 。

kill-window [-a] [-t 目 標 視 窗 ]

(別 名 ： Ic killw)

銷 燬 當 前 視 窗 或 目 標 視 窗 中 的 視 窗 ， 並 將 其 從 任 何 關 聯 的 會 話 中 移 除 。 -a 選 項 會 銷 燬 除 使 用 -t 給 出 的 視 窗 之 外 的 所 有 視 窗 。

last-pane [-deZ] [-t 目 標 視 窗 ]

(別 名 ： Ic lastp)

選 擇 上 一 個 （ 先 前 選 擇 的 ） 窗 格 。 -Z 在 窗 格 處 於 最 大 化 狀 態 時 保 持 最 大 化 狀 態 。 -e 啟 用 ， -d 禁 用 窗 格 的 輸 入 。

last-window [-t 目 標 會 話 ]

(別 名 ： Ic last)

選 擇 上 一 個 （ 先 前 選 擇 的 ） 視 窗 。 如 果 未 指 定 目 標 會 話 ， 則 選 擇 當 前 會 話 的 最 後 一 個 視 窗 。

link-window [-abdk] [-s 源 視 窗 ] [-t 目 的 視 窗 ]

(別 名 ： Ic linkw)

將 源 視 窗 視 窗 連 結 到 指 定 的 目 的 視 窗 視 窗 。 如 果 指 定 了 目 的 視 窗 ， 但 沒 有 這 樣 的 視 窗 ， 則 將 源 視 窗 連 結 到 該 位 置 。 使 用 -a 或 -b ， 視 窗 將 移 動 到 目 的 視 窗 之 後 或 之 前 的 下 一 個 索 引 位 置 （ 必 要 時 移 動 現 有 視 窗 ） 。 如 果 給 出 了 -k 並 且 目 的 視 窗 存 在 ， 則 銷 燬 它 ， 否 則 會 生 成 一 個 錯 誤 。 如 果 給 出 了 -d ， 則 不 會 選 擇 新 連 結 的 視 窗 。

list-panes [-as] [-F 格 式 ] [-f 過 濾 器 ] [-t 目 標 ]

(別 名 ： Ic lsp)

如 果 給 出 了 -a ， 則 忽 略 目 標 並 列 出 伺 服 器 上 的 所 有 窗 格 。 如 果 給 出 了 -s ， 則 目 標 是 一 個 會 話 （ 或 當 前 會 話 ） 。 如 果 兩 者 都 沒 有 給 出 ， 則 目 標 是 一 個 視 窗 （ 或 當 前 視 窗 ） 。 -F 指 定 每 行 的 格 式 ， -f 指 定 過 濾 器 。 只 顯 示 過 濾 器 為 true 的 窗 格 。 請 參 見 格 式 部 分 。

list-windows [-a] [-F 格 式 ] [-f 過 濾 器 ] [-t 目 標 會 話 ]

(別 名 ： Ic lsw)

如 果 給 出 了 -a ， 則 列 出 伺 服 器 上 的 所 有 視 窗 。 否 則 ， 列 出 當 前 會 話 或 目 標 會 話 中 的 視 窗 。 -F 指 定 每 行 的 格 式 ， -f 指 定 過 濾 器 。 只 顯 示 過 濾 器 為 true 的 視 窗 。 請 參 見 格 式 部 分 。

move-pane [-bdfhv] [-l 尺 寸 ] [-s 源 窗 格 ] [-t 目 的 窗 格 ]

(別 名 ： Ic movep)

和 join-pane 一 樣 。

move-window [-abrdk] [-s 源 視 窗 ] [-t 目 的 視 窗 ]

(別 名 ： Ic movew)

這 類 似 於 link-window ， 但 是 將 源 視 窗 中 的 視 窗 移 動 到 目 的 窗 口 中 。 使 用 -r ， 會 話 中 的 所 有 視 窗 都 按 順 序 重 新 編 號 ， 遵 守 base-index 選 項 。

new-window [-abdkPS] [-c 起 始 目 錄 ] [-e 環 境 ] [-F 格 式 ] [-n 視 窗 名 稱 ] [-t 目 標 窗 戶 ] [外 殼 命 令 ]

(別 名 ： Ic neww)

建 立 一 個 新 視 窗 。 使 用 -a 或 -b ， 新 視 窗 將 在 指 定 的 目 標 視 窗 之 後 或 之 前 的 下 一 個 索 引 位 置 插 入 ， 如 果 必 要 ， 視 窗 會 向 上 移 動 ； 否 則 ， 目 標 窗 口 就 是 新 視 窗 的 位 置 。

如 果 給 出 了 -d ， 則 會 話 不 會 將 新 視 窗 設 定 為 當 前 視 窗 。 目 標 視 窗 表 示 要 建 立 的 視 窗 ； 如 果 目 標 已 經 存 在 ， 則 會 顯 示 錯 誤 ， 除 非 使 用 了 -k 標 誌 ， 在 這 種 情 況 下 ， 它 將 被 銷 燬 。 如 果 給 出 了 -S 並 且 已 經 存 在 一 個 名 為 視 窗 名 稱 的 視 窗 ， 則 選 擇 該 視 窗 （ 除 非 還 給 出 了 -d ， 在 這 種 情 況 下 ， 該 命 令 不 執 行 任 何 操 作 ） 。

外 殼 命 令 是 要 執 行 的 命 令 。 如 果 未 指 定 外 殼 命 令 ， 則 使 用 default-command 選 項 的 值 。 -c 指 定 建 立 新 視 窗 的 工 作 目 錄 。

當 外 殼 命 令 完 成 後 ， 視 窗 會 關 閉 。 請 參 見 remain-on-exit 選 項 以 更 改 此 行 為 。

-e 的 格 式 為 ’VARIABLE=value’ ， 用 於 為 新 建 立 的 視 窗 設 定 環 境 變 數 ； 可 以 指 定 多 次 。

所 有 在 tmux 中 執 行 的 程 式 ， 其 TERM 環 境 變 數 必 須 設 定 為 ’screen’ 或 ’tmux’ 。 新 視 窗 將 自 動 在 其 環 境 中 新 增 ’TERM=screen’ ， 但 是 必 須 注 意 不 要 在 shell 啟 動 檔 案 或 -e 選 項 中 重 置 此 變 數 。

使 用 -P 選 項 ， 在 建 立 新 視 窗 後 列 印 有 關 視 窗 的 資 訊 。 預 設 情 況 下 ， 它 使 用 格 式 ’#{session_name}:#{window_index}’ ， 但 是 可 以 使 用 -F 指 定 不 同 的 格 式 。

next-layout [-t 目 標 視 窗 ]

(別 名 ： Ic nextl)

將 視 窗 移 動 到 下 一 個 佈 局 並 重 新 排 列 窗 格 以 適 合 。

next-window [-a] [-t 目 標 會 話 ]

(別 名 ： Ic next)

移 動 到 會 話 中 的 下 一 個 視 窗 。 如 果 使 用 了 -a ， 則 移 動 到 具 有 警 報 的 下 一 個 視 窗 。

pipe-pane [-IOo] [-t 目 標 窗 格 ] [外 殼 命 令 ]

(別 名 ： Ic pipep)

將 由 目 標 窗 格 中 的 程 式 傳 送 的 輸 出 管 道 傳 輸 到 外 殼 命 令 中 ， 或 者 反 之 亦 然 。 一 個 窗 格 每 次 只 能 連 線 到 一 個 命 令 ， 執 行 外 殼 命 令 前 會 關 閉 任 何 現 有 的 管 道 。 外 殼 命 令 字 串 可 以 包 含 status-left 選 項 支 援 的 特 殊 字 元 序 列 。 如 果 沒 有 給 出 外 殼 命 令 ， 則 關 閉 當 前 的 管 道 （ 如 果 有 ） 。

-I 和 -O 指 定 連 線 到 窗 格 的 外 殼 命 令 輸 出 流 ： 使 用 -I ， 將 連 線 stdout（ 因 此 ， 外 殼 命 令 列 印 的 任 何 內 容 都 會 被 寫 入 窗 格 ， 就 好 像 是 手 動 輸 入 的 一 樣 ） ； 使 用 -O ， 將 連 線 stdin（ 因 此 ， 窗 格 中 的 任 何 輸 出 都 會 被 管 道 傳 輸 到 外 殼 命 令 ） 。 兩 者 都 可 以 一 起 使 用 。 如 果 兩 者 都 沒 有 指 定 ， 則 使 用 -O 。

只 有 在 不 存 在 先 前 的 管 道 的 情 況 下 ， -o 選 項 才 會 開 啟 新 的 管 道 ， 允 許 透 過 單 個 按 鍵 切 換 管 道 ， 例 如 ：

bind-key C-p pipe-pane -o ’cat >>~/output.#I-#P’

previous-layout [-t 目 標 視 窗 ]

(別 名 ： Ic prevl)

移 動 到 會 話 中 的 上 一 個 佈 局 。

previous-window [-a] [-t 目 標 會 話 ]

(別 名 ： Ic prev)

移 動 到 會 話 中 的 上 一 個 視 窗 。 如 果 使 用 了 -a ， 則 移 動 到 具 有 警 報 的 上 一 個 視 窗 。

rename-window [-t 目 標 視 窗 ] 新 名 稱

(別 名 ： Ic renamew)

將 當 前 視 窗 或 指 定 的 目 標 視 窗 視 窗 （ 如 果 指 定 ） 重 新 命 名 為 新 名 稱 。

resize-pane [-DLMRTUZ] [-t 目 標 窗 格 ] [-x 寬 度 ] [-y 高 度 ] [adjustment]

(別 名 ： Ic resizep)

使 用 -U 、 -D 、 -L 或 -R ， 將 窗 格 向 上 、 向 下 、 向 左 或 向 右 調 整 adjustment ， 或 使 用 -x 或 -y 調 整 到 絕 對 大 小 。 adjustment 以 行 或 列 為 單 位 給 出 （ 預 設 為 1） ； -x 和 -y 可 以 作 為 行 或 列 的 數 量 給 出 ， 也 可 以 在 其 後 加 上 ’%’ ， 表 示 視 窗 大 小 的 百 分 比 （ 例 如 ’-x 10%’ ） 。 使 用 -Z ， 活 動 窗 格 在 縮 放 （ 佔 據 整 個 視 窗 ） 和 未 縮 放 （ 在 佈 局 中 的 正 常 位 置 ） 之 間 切 換 。

-m 開 始 調 整 滑 鼠 大 小 （ 僅 當 繫 結 到 滑 鼠 鍵 繫 結 時 才 有 效 ， 請 參 閱 滑 鼠 支 持 ） 。

-t 修 剪 當 前 游 標 位 置 下 方 的 所 有 行 ， 並 將 行 移 出 歷 史 記 錄 以 替 換 它 們 。

resize-window [-aADLRU] [-t 目 標 視 窗 ] [-x 寬 度 ] [-y 高 度 ] [adjustment]

(別 名 ： Ic resizew)

使 用 -U 、 -D 、 -L 或 -R ， 將 視 窗 向 上 、 向 下 、 向 左 或 向 右 調 整 adjustment ， 或 使 用 -x 或 -y 調 整 到 絕 對 大 小 。 adjustment 以 行 或 單 元 格 為 單 位 給 出 （ 預 設 為 1） 。 -A 設 定 包 含 視 窗 的 最 大 會 話 的 大 小 ； -a 設 定 最 小 會 話 的 大 小 。 此 命 令 將 自 動 將 window-size 設 定 為 手 動 模 式 。

respawn-pane [-k] [-c 起 始 目 錄 ] [-e 環 境 ] [-t 目 標 窗 格 ] [外 殼 命 令 ]

(別 名 ： Ic respawnp)

在 命 令 退 出 的 窗 格 中 重 新 啟 用 命 令 （ 請 參 見 remain-on-exit 視 窗 選 項 ） 。 如 果 未 給 出 外 殼 命 令 ， 則 執 行 建 立 或 最 後 重 新 生 成 窗 格 時 使 用 的 命 令 。 窗 格 必 須 已 處 於 非 活 動 狀 態 ， 除 非 給 出 了 -k ， 在 這 種 情 況 下 ， 將 終 止 任 何 現 有 的 命 令 。 -c 為 窗 格 指 定 新 的 工 作 目 錄 。 -e 選 項 的 含 義 與 new-window 命 令 相 同 。

respawn-window [-k] [-c 起 始 目 錄 ] [-e 環 境 ] [-t 目 標 窗 口 ] [外 殼 命 令 ]

(別 名 ： Ic respawnw)

在 命 令 退 出 的 視 窗 中 重 新 啟 用 命 令 （ 請 參 見 remain-on-exit 視 窗 選 項 ） 。 如 果 未 給 出 外 殼 命 令 ， 則 執 行 建 立 或 最 後 重 新 生 成 視 窗 時 使 用 的 命 令 。 視 窗 必 須 已 處 於 非 活 動 狀 態 ， 除 非 給 出 了 -k ， 在 這 種 情 況 下 ， 將 終 止 任 何 現 有 的 命 令 。 -c 為 視 窗 指 定 新 的 工 作 目 錄 。 -e 選 項 的 含 義 與 new-window 命 令 相 同 。

rotate-window [-DUZ] [-t 目 標 視 窗 ]

(別 名 ： Ic rotatew)

旋 轉 視 窗 內 窗 格 的 位 置 ， 可 以 使 用 -U 向 上 （ 數 字 更 低 ） 旋 轉 ， 也 可 以 向 下 （ 數 字 更 高 ） 旋 轉 。 如 果 視 窗 已 縮 放 ， 則 使 用 -Z 保 持 視 窗 縮 放 。

select-layout [-Enop] [-t 目 標 窗 格 ] [佈 局 名 稱 ]

(別 名 ： Ic selectl)

為 視 窗 選 擇 特 定 的 佈 局 。 如 果 未 給 出 佈 局 名 稱 ， 則 重 新 應 用 上 一 次 使 用 的 預 設 佈 局 （ 如 果 有 ） 。 -n 和 -p 等 同 於 next-layout 和 previous-layout 命 令 。 -o 在 可 能 的 情 況 下 應 用 最 後 設 定 的 佈 局 （ 撤 銷 最 近 的 佈 局 更 改 ） 。 -E 將 當 前 窗 格 和 其 旁 邊 的 任 何 窗 格 均 勻 展 開 。

select-pane [-DdeLlMmRUZ] [-T 標 題 ] [-t 目 標 窗 格 ]

(別 名 ： Ic selectp)

將 窗 格 目 標 窗 格 設 定 為 其 視 窗 中 的 活 動 窗 格 。 如 果 使 用 了 -D 、 -L 、 -R 或 -U 中 的 一 個 ， 則 分 別 使 用 目 標 窗 格 下 方 、 左 側 、 右 側 或 上 方 的 窗 格 。 如 果 視 窗 已 縮 放 ， 則 使 用 -Z 保 持 視 窗 縮 放 。 -l 等 同 於 使 用 last-pane 命 令 。 -e 啟 用 或 -d 禁 用 窗 格 的 輸 入 。 -T 設 定 窗 格 標 題 。

使 用 -m 和 -M 分 別 設 定 和 清 除 標 記 窗 格 。 一 次 只 有 一 個 標 記 窗 格 ， 設 定 新 的 標 記 窗 格 會 清 除 上 一 個 標 記 窗 格 。 標 記 窗 格 是 -s 、 join-pane 、 move-pane 、 swap-pane 和 swap-window 的 預 設 目 標 。

select-window [-lnpT] [-t 目 標 視 窗 ]

(別 名 ： Ic selectw)

選 擇 目 標 視 窗 視 窗 。 -l 、 -n 和 -p 分 別 等 同 於 last-window 、 next-window 和 previous-window 命 令 。 如 果 給 出 -T 並 且 所 選 視 窗 已 經 是 當 前 視 窗 ， 則 該 命 令 的 行 為 類 似 於 last-window 。

split-window [-bdfhIvPZ] [-c 起 始 目 錄 ] [-e 環 境 ] [-l 尺 寸 ] [-t 目 標 窗 格 ] [外 殼 命 令 ] [-F 格 式 ]

(別 名 ： Ic splitw)

透 過 分 割 目 標 窗 格 建 立 新 的 窗 格 ： -h 進 行 水 平 分 割 ， -v 進 行 垂 直 分 割 ； 如 果 沒 有 指 定 ， 則 預 設 為 -v 。 -l 選 項 指 定 新 窗 格 的 大 小 ， 以 行 （ 垂 直 分 割 ） 或 列 （ 水 平 分 割 ） 為 單 位 ； 尺 寸 可 以 後 跟 ’%’ ， 以 指 定 可 用 空 間 的 百 分 比 。 -b 選 項 將 建 立 新 的 窗 格 置 於 目 標 窗 格 的 左 側 或 上 方 。 -f 選 項 建 立 一 個 跨 越 整 個 視 窗 高 度 （ 使 用 -h ） 或 整 個 視 窗 寬 度 （ 使 用 -v ） 的 新 窗 格 ， 而 不 是 分 割 活 動 窗 格 。 如 果 視 窗 未 縮 放 ， 則 使 用 -Z 進 行 縮 放 ， 如 果 已 經 縮 放 ， 則 保 持 視 窗 縮 放 。

空 的 外 殼 命 令 （ ’’） 將 建 立 一 個 沒 有 執 行 命 令 的 窗 格 。 可 以 使 用 display-message 命 令 將 輸 出 傳 送 到 此 類 窗 格 。 如 果 未 指 定 或 為 空 外 殼 命 令 ， 則 -I 標 誌 將 建 立 一 個 空 的 窗 格 ， 並 將 任 何 來 自 標 準 輸 入 的 輸 出 轉 發 到 該 窗 格 。 例 如 ：

$ make 2>&1|tmux splitw -dI &

所 有 其 他 選 項 與 new-window 命 令 具 有 相 同 的 含 義 。

swap-pane [-dDUZ] [-s 源 窗 格 ] [-t 目 的 窗 格 ]

(別 名 ： Ic swapp)

交 換 兩 個 窗 格 。 如 果 使 用 了 -U ， 並 且 沒 有 使 用 -s 指 定 源 窗 格 ， 則 目 的 窗 格 將 與 其 前 一 個 窗 格 （ 在 數 字 上 ） 交 換 ； -D 則 與 下 一 個 窗 格 交 換 （ 在 數 字 上 ） 。 -d 指 示 tmux 不 更 改 活 動 窗 格 ， -Z 在 視 窗 已 縮 放 的 情 況 下 保 持 視 窗 縮 放 。

如 果 省 略 -s ， 並 且 存 在 標 記 的 窗 格 （ 參 見 select-pane -m ） ， 則 使 用 標 記 的 窗 格 而 不 是 當 前 窗 格 。

swap-window [-d] [-s 源 視 窗 ] [-t 目 的 視 窗 ]

(別 名 ： Ic swapw)

這 類 似 於 link-window ， 但 源 視 窗 和 目 標 視 窗 被 交 換 。 如 果 在 源 視 窗 中 不 存 在 視 窗 ， 則 會 出 錯 。 如 果 給 出 -d ， 則 新 視 窗 不 會 成 為 當 前 視 窗 。

如 果 省 略 了 -s 並 且 存 在 標 記 窗 格 （ 請 參 見 select-pane -m ） ， 則 使 用 包 含 標 記 窗 格 的 視 窗 ， 而 不 是 當 前 視 窗 。

unlink-window [-k] [-t 目 標 視 窗 ]

(別 名 ： Ic unlinkw)

取 消 連 結 目 標 窗 戶 。 除 非 給 出 -k ， 否 則 只 有 當 視 窗 連 結 到 多 個 會 話 時 ， 才 能 取 消 連 結 視 窗 - 視 窗 不 能 連 結 到 沒 有 會 話 的 情 況 ； 如 果 指 定 了 -k 並 且 視 窗 只 連 結 到 一 個 會 話 ， 則 它 會 被 取 消 連 結 並 刪 除 。

按 鍵 繫 結

tmux 允 許 將 命 令 繫 結 到 大 多 數 鍵 上 ， 帶 或 不 帶 字 首 鍵 。 在 指 定 鍵 時 ， 大 多 數 鍵 表 示 它 們 自 己 （ 例 如 從 ’A’ 到 ’Z’ ） 。 Ctrl 鍵 可 以 加 上 ’C-’ 或 ’^’ ， Shift 鍵 可 以 加 上 ’S-’ ， Alt（ meta） 鍵 可 以 加 上 ’M-’ 。 此 外 ， 還 接 受 以 下 特 殊 鍵 名 ： Up 、 Down 、 Left 、 Right 、 BSpace 、 BTab 、 DC （ 刪 除 鍵 ） 、 End 、 Enter 、 Escape 、 F1 到 F12 、 Home 、 IC （ 插 入 鍵 ） 、 NPage/PageDown/PgDn 、 PPage/PageUp/PgUp 、 Space 和 Tab 。 請 注 意 ， 要 繫 結 ’"’ 或 ’’’ 鍵 ， 需 要 使 用 引 號 ， 例 如 ：

bind-key ’"’ split-window
bind-key "’" new-window

繫 結 到 Any 鍵 的 命 令 將 對 所 有 沒 有 更 具 體 繫 結 的 鍵 執 行 。

與 按 鍵 繫 結 相 關 的 命 令 如 下 ：

bind-key [-nr] [-N 筆 記 ] [-T 快 捷 鍵 表 ] 快 捷 鍵 命 令 [引 數 ...]

(別 名 ： Ic bind)

將 鍵 快 捷 鍵 繫 結 到 命 令 命 令 。 鍵 在 鍵 表 中 繫 結 。 預 設 情 況 下 （ 沒 有 -T） ， 鍵 會 繫 結 在 prefix 鍵 表 中 。 該 表 用 於 按 下 字 首 鍵 後 按 下 的 鍵 （ 例 如 ， 默 認 情 況 下 ’c’ 在 prefix 表 中 繫 結 到 new-window ， 因 此 ’C-b c’ 會 建 立 一 個 新 視 窗 ） 。 root 表 用 於 不 使 用 字 首 鍵 按 下 的 鍵 ： 將 ’c’ 繫 結 到 new-window 在 root 表 中 （ 不 建 議 這 樣 做 ） 意 味 著 一 個 簡 單 的 ’c’ 將 建 立 一 個 新 視 窗 。 -n 是 -T root 的 別 名 。 鍵 也 可 以 綁 定 到 自 定 義 鍵 表 中 ， 並 使 用 switch-client -T 命 令 從 鍵 繫 結 中 切 換 到 它 們 。 -r 標 誌 表 示 此 鍵 可 以 重 複 使 用 ， 請 參 見 repeat-time 選 項 。 -N 附 加 一 個 註 釋 到 鍵 上 （ 使 用 list-keys -N 顯 示 ） 。

要 檢 視 預 設 繫 結 和 可 能 的 命 令 ， 請 參 閱 list-keys 命 令 。

list-keys [-1aN] [-P 字 首 字 串 -T 快 捷 鍵 表 ] [快 捷 鍵 ]

(別 名 ： Ic lsk)

列 出 鍵 繫 結 。 有 兩 種 形 式 ： 預 設 情 況 下 ， 以 bind-key 命 令 的 形 式 列 出 鍵 ； -N 僅 列 出 帶 有 附 加 註 釋 的 鍵 ， 並 僅 顯 示 每 個 鍵 和 註 釋 的 鍵 和 註 釋 。

預 設 情 況 下 ， 使 用 預 設 形 式 列 出 所 有 鍵 表 。 -T 僅 列 出 快 捷 鍵 表 中 的 鍵 。

在 -N 形 式 下 ， 預 設 僅 列 出 root 和 prefix 鍵 表 中 的 鍵 ； -T 也 僅 列 出 快 捷 鍵 表 中 的 鍵 。 -P 指 定 在 每 個 鍵 前 要 列 印 的 字 首 ， -1 僅 列 出 第 一 個 匹 配 的 鍵 。 -a 列 出 沒 有 註 釋 的 鍵 的 命 令 ， 而 不 是 跳 過 它 們 。

send-keys [-FHKlMRX] [-c 目 標 客 戶 端 ] [-N 重 複 計 數 ] [-t 目 標 窗 格 ] 快 捷 鍵 ...

(別 名 ： Ic send)

將 一 個 或 多 個 鍵 傳 送 到 視 窗 。 每 個 引 數 快 捷 鍵 都 是 要 傳 送 的 鍵 的 名 稱 （ 例 如 ’C-a’ 或 ’NPage’ ） ； 如 果 字 串 不 能 被 識 別 為 鍵 ， 則 它 將 作 為 一 系 列 字 元 傳 送 。 所 有 引 數 按 順 序 從 第 一 個 到 最 後 一 個 傳 送 。 如 果 沒 有 給 出 鍵 並 且 該 命 令 繫 結 到 一 個 鍵 ， 則 使 用 該 鍵 。

-l 標 誌 禁 用 鍵 名 稱 查 詢 ， 並 將 鍵 處 理 為 字 面 的 UTF-8 字 元 。 -H 標 誌 期 望 每 個 鍵 都 是 ASCII 字 元 的 十 六 進 位 制 數 字 。

-R 標 誌 導 致 終 端 狀 態 被 重 置 。

-M 傳 遞 滑 鼠 事 件 （ 僅 當 繫 結 到 滑 鼠 鍵 繫 結 時 才 有 效 ， 請 參 閱 滑 鼠 支 援 ） 。

-X 用 於 將 命 令 傳 送 到 複 製 模 式 - 請 參 閱 窗 戶 和 窗 格 部 分 。 -N 指 定 重 複 計 數 ， -F 在 適 當 的 引 數 中 展 開 格 式 。

send-prefix [-2] [-t 目 標 窗 格 ]

傳 送 字 首 鍵 ， 或 者 如 果 按 下 字 首 鍵 ， 發 送 -2 次 要 字 首 鍵 ， 就 像 它 被 按 下 一 樣 。

unbind-key [-anq] [-T 快 捷 鍵 表 ] 快 捷 鍵

(別 名 ： Ic unbind)

取 消 繫 結 繫 結 到 key 的 命 令 。 -n 和 -T 與 bind-key 相 同 。 如 果 存 在 -a ， 則 刪 除 所 有 鍵 繫 結 。 -q 選 項 可 以 防 止 返 回 錯 誤 。

選 項

可 以 透 過 更 改 各 種 選 項 的 值 來 修 改 tmux 的 外 觀 和 行 為 。 有 四 種 類 型 的 選 項 ： 伺 服 器 選 項 、 會 話 選 項 、 視 窗 選 項 和 窗 格 選 項 。

tmux 伺 服 器 具 有 一 組 全 域 性 伺 服 器 選 項 ， 這 些 選 項 不 適 用 於 任 何 特 定 的 視 窗 、 會 話 或 面 板 。 這 些 選 項 可 以 使 用 set-option -s 命 令 進 行 更 改 ， 或 者 可 以 使 用 show-options -s 命 令 進 行 顯 示 。

此 外 ， 每 個 單 獨 的 會 話 可 以 有 一 組 會 話 選 項 ， 還 有 一 組 單 獨 的 全 域 性 會 話 選 項 。 沒 有 配 置 特 定 選 項 的 會 話 會 從 全 域 性 會 話 選 項 繼 承 該 值 。 會 話 選 項 可 以 使 用 set-option 命 令 設 定 或 取 消 設 定 ， 並 可 以 使 用 show-options 命 令 列 出 。 可 用 的 伺 服 器 和 會 話 選 項 在 set-option 命 令 下 列 出 。

同 樣 ， 每 個 視 窗 都 有 一 組 視 窗 選 項 ， 每 個 窗 格 都 有 一 組 窗 格 選 項 。 窗 格 選 項 繼 承 自 視 窗 選 項 。 這 意 味 著 可 以 將 任 何 窗 格 選 項 設 定 為 視 窗 選 項 ， 以 將 該 選 項 應 用 於 視 窗 中 未 設 定 選 項 的 所 有 窗 格 。 例 如 ， 以 下 命 令 將 為 除 窗 格 0 之 外 的 所 有 窗 格 設 定 背 景 顏 色 為 紅 色 ：

set -w window-style bg=red
set -pt:.0 window-style bg=blue

還 有 一 組 全 域 性 視 窗 選 項 ， 從 中 繼 承 任 何 未 設 定 的 視 窗 或 窗 格 選 項 。 可 以 使 用 set-option -w 和 -p 命 令 更 改 視 窗 和 窗 格 選 項 ， 並 使 用 show-option -w 和 -p 顯 示 它 們 。

tmux 還 支 援 以 ’@’ 為 字 首 的 使 用 者 選 項 。 使 用 者 選 項 可 以 具 有 任 何 名 稱 ， 只 要 它 們 以 ’@’ 為 字 首 ， 並 且 可 以 設 定 為 任 何 字 串 。 例 如 ：

$ tmux set -wq @foo "abc123"
$ tmux show -wv @foo
abc123

設 定 選 項 的 命 令 如 下 ：

set-option [-aFgopqsuUw] [-t 目 標 窗 格 ] 選 項 值

(別 名 ： Ic set)

使 用 -p 設 定 窗 格 選 項 ， 使 用 -w 設 定 視 窗 選 項 ， 使 用 -s 設 定 服 務 器 選 項 ， 否 則 使 用 會 話 選 項 。 如 果 選 項 不 是 使 用 者 選 項 ， 則 -w 或 -s 可 能 是 不 必 要 的 - tmux 將 根 據 選 項 名 稱 推 斷 型 別 ， 假 設 對 於 窗 格 選 項 ， 使 用 -w 。 如 果 給 出 -g ， 則 設 定 全 域 性 會 話 或 視 窗 選 項 。

-F 展 開 選 項 值 中 的 格 式 。 -u 標 誌 取 消 設 定 選 項 ， 所 以 會 話 將 從 全 域 性 選 項 繼 承 該 選 項 （ 或 者 使 用 -g ， 將 全 域 性 選 項 還 原 為 預 設 值 ） 。 -U 取 消 設 定 選 項 （ 類 似 於 -u ） ， 但 如 果 選 項 是 窗 格 選 項 ， 則 還 取 消 設 定 視 窗 中 任 何 窗 格 上 的 選 項 。 value 取 決 於 選 項 ， 可 以 是 數 字 、 字 串 或 標 誌 （ on、 off 或 省 略 以 進 行 切 換 ） 。

-o 標 誌 可 防 止 設 定 已 設 定 的 選 項 ， -q 標 誌 可 抑 制 有 關 未 知 或 不 明 確 選 項 的 錯 誤 。

使 用 -a ， 如 果 選 項 需 要 字 串 或 樣 式 ， 則 將 值 附 加 到 現 有 設 定 。 例 如 ：

set -g status-left "foo"
set -ag status-left "bar"

將 導 致 ’foobar’ 。 和 ：

set -g status-style "bg=red"
set -ag status-style "fg=blue"

將 導 致 紅 色 背 景 和 藍 色 前 景 。 如 果 沒 有 -a ， 結 果 將 是 預 設 背 景 和 藍 色 前 景 。

show-options [-AgHpqsvw] [-t 目 標 窗 格 ] [選 項 ]

(別 名 ： Ic show)

使 用 -p 顯 示 窗 格 選 項 （ 或 者 如 果 提 供 了 選 項 ， 則 顯 示 單 個 選 項 ） ， 使 用 -w 顯 示 視 窗 選 項 ， 使 用 -s 顯 示 伺 服 器 選 項 ， 否 則 顯 示 會 話 選 項 。 如 果 選 項 不 是 使 用 者 選 項 ， 則 -w 或 -s 可 能 是 不 必 要 的 - tmux 將 根 據 選 項 名 稱 推 斷 型 別 ， 假 設 對 於 窗 格 選 項 ， 使 用 -w 。 如 果 使 用 -g ， 則 列 出 全 局 會 話 或 視 窗 選 項 。 -v 僅 顯 示 選 項 值 ， 不 顯 示 名 稱 。 如 果 設 定 了 -q ， 則 在 取 消 設 定 選 項 時 不 會 返 回 錯 誤 。 -H 包 括 鉤 子 （ 預 設 情 況 下 省 略 ） 。 -A 包 括 從 父 選 項 集 繼 承 的 選 項 ， 這 些 選 項 帶 有 星 號 標 記 。

可 用 的 伺 服 器 選 項 是 ：

backspace 快 捷 鍵

設 定 由 tmux 傳 送 的 退 格 鍵 。

buffer-limit 數 字

設 定 緩 衝 區 的 數 量 ； 當 新 緩 衝 區 新 增 到 堆 疊 頂 部 時 ， 如 有 必 要 ， 舊 緩 衝 區 將 從 底 部 移 除 以 保 持 此 最 大 長 度 。

command-alias[] name=value

這 是 命 令 的 自 定 義 別 名 陣 列 。 如 果 未 知 命 令 與 名 稱 匹 配 ， 則 將 其 替 換 為 值 。 例 如 ， 之 後 ：

set -s command-alias[100] zoom=’resize-pane -Z’

使 用 ：

zoom -t:.1

相 當 於 ：

resize-pane -Z -t:.1

請 注 意 別 名 是 在 解 析 命 令 時 而 不 是 在 執 行 命 令 時 擴 充 套 件 的 ， 因 此 使 用 bind-key 綁 定 別 名 將 繫 結 擴 充 套 件 形 式 。

default-terminal 終 端

設 定 在 此 會 話 中 建 立 的 新 視 窗 的 預 設 終 端 - TERM 環 境 變 數 的 預 設 值 。 為 了 使 tmux 正 常 工 作 ， 必 須 將 其 設 定 為 ’screen’ 、 ’tmux’ 或 其 衍 生 產 品 。

copy-command shell-command

如 果 使 用 不 帶 引 數 的 copy-pipe 複 製 模 式 命 令 ， 則 將 命 令 傳 遞 給 管 道 。

escape-time time

設 定 輸 入 轉 義 後 tmux 等 待 的 時 間 （ 以 毫 秒 為 單 位 ） ， 以 確 定 它 是 否 是 函 式 或 元 鍵 序 列 的 一 部 分 。 預 設 值 為 500 毫 秒 。

editor shell-command

設 定 tmux 執 行 編 輯 器 時 使 用 的 命 令 。

exit-empty [on | off]

如 果 啟 用 （ 預 設 ） ， 伺 服 器 將 在 沒 有 活 動 會 話 時 退 出 。

exit-unattached [on | off]

如 果 啟 用 ， 伺 服 器 將 在 沒 有 連 線 的 客 戶 端 時 退 出 。

extended-keys [on | off | always]

當 on 或 always 時 ， 啟 用 擴 充 套 件 鍵 的 轉 義 序 列 被 髮 送 到 終 端 ， 如 果 tmux 知 道 它 受 支 援 。 tmux 始 終 識 別 擴 充 套 件 快 捷 鍵 本 身 。 如 果 這 個 選 項 是 on ， tmux 只 會 在 應 用 程 式 請 求 時 將 擴 充 套 件 快 捷 鍵 轉 發 給 應 用 程 式 ； 如 果 always ， tmux 將 始 終 轉 發 快 捷 鍵 。

focus-events [on | off]

啟 用 此 選 項 後 ， 如 果 終 端 支 援 ， 將 從 終 端 請 求 焦 點 事 件 ， 並 將 其 傳 遞 到 在 tmux 中 執 行 的 應 用 程 式 。 更 改 此 選 項 後 ， 應 分 離 並 重 新 附 加 已 連 線 的 客 戶 端 。

history-file 路 徑

如 果 不 為 空 ， 則 指 定 一 個 檔 案 ， 在 退 出 時 tmux 將 命 令 提 示 符 歷 史 記 錄 寫 入 該 檔 案 ， 並 在 啟 動 時 從 該 檔 案 載 入 歷 史 記 錄 。

message-limit 數 字

設 定 要 儲 存 在 每 個 客 戶 端 的 訊 息 日 誌 中 的 錯 誤 或 資 訊 訊 息 的 數 量 。

prompt-history-limit 數 字

為 每 種 型 別 的 命 令 提 示 符 設 定 要 儲 存 在 歷 史 檔 案 中 的 歷 史 專 案 數 。

set-clipboard [on | external | off]

嘗 試 使 用 xterm(1) 轉 義 序 列 設 定 終 端 剪 貼 簿 內 容 ， 如 果 terminfo(5) 描 述 中 有 Ms 條 目 （ 請 參 見 終 端 資 訊 擴 充 套 件 章 節 ） 。

如 果 設 定 為 on ， 則 tmux 將 接 受 轉 義 序 列 以 建 立 緩 衝 區 ， 並 嘗 試 設 定 終 端 剪 貼 板 。 如 果 設 定 為 external ， tmux 將 嘗 試 設 定 終 端 剪 貼 簿 ， 但 忽 略 應 用 程 式 設 定 tmux 緩 衝 區 的 嘗 試 。 如 果 設 定 為 off ， 則 tmux 既 不 接 受 剪 貼 簿 轉 義 序 列 ， 也 不 嘗 試 設 定 剪 貼 簿 。

請 注 意 ， 需 要 透 過 設 定 資 源 在 xterm(1) 中 啟 用 此 功 能 ：

disallowedWindowOps: 20,21,SetXprop

或 在 需 要 時 從 xterm(1) 互 動 式 選 單 更 改 此 屬 性 。

terminal-features[] 字 串

為 從 terminfo(5) 讀 取 的 終 端 型 別 設 定 終 端 功 能 。 tmux 有 一 組 命 名 終 端 功 能 。 每 個 終 端 功 能 將 應 用 適 當 的 更 改 到 正 在 使 用 的 terminfo(5) 條 目 中 。

tmux 可 以 檢 測 一 些 常 見 終 端 的 特 性 ； 該 選 項 可 以 用 來 告 訴 tmux 關 於 它 無 法 檢 測 到 的 終 端 支 援 的 特 性 。 terminal-overrides 選 項 允 許 設 定 單 個 terminfo(5) 功 能 ， 而 terminal-features 則 用 於 標 準 方 式 支 援 的 功 能 類 別 ， 但 terminfo(5) 未 報 告 。 必 須 小 心 配 置 此 功 能 ， 僅 使 用 終 端 實 際 支 援 的 功 能 。

這 是 一 個 數 組 選 項 ， 其 中 每 個 條 目 都 是 由 終 端 型 別 模 式 （ 使 用 fnmatch(3) 匹 配 ） 後 跟 終 端 功 能 列 表 組 成 的 冒 號 分 隔 字 串 。 可 用 的 功 能 包 括 ：

256

使 用 SGR 轉 義 序 列 支 援 256 種 顏 色 。

clipboard

允 許 設 定 系 統 剪 貼 簿 。

ccolour

允 許 設 定 游 標 顏 色 。

cstyle

允 許 設 定 游 標 樣 式 。

extkeys

支 援 擴 充 套 件 鍵 。

focus

支 援 焦 點 報 告 。

margins

支 援 DECSLRM 邊 距 。

mouse

支 援 xterm(1) 滑 鼠 序 列 。

osc7

支 援 OSC 7 工 作 目 錄 擴 充 套 件 。

overline

支 援 上 劃 線 SGR 屬 性 。

rectfill

支 援 DECFRA 矩 形 填 充 轉 義 序 列 。

RGB

支 援 帶 有 SGR 轉 義 序 列 的 紅 綠 藍 顏 色 。

strikethrough

支 援 刪 除 線 SGR 轉 義 序 列 。

sync

支 援 同 步 更 新 。

title

支 援 xterm(1) 標 題 設 定 。

usstyle

允 許 設 定 下 劃 線 樣 式 和 顏 色 。

terminal-overrides[] 字 串

允 許 覆 蓋 使 用 terminfo(5) 讀 取 的 終 端 描 述 。 每 個 條 目 都 是 由 終 端 型 別 模 式 （ 使 用 fnmatch(3) 匹 配 ） 和 一 組 名 稱 =值 條 目 組 成 的 由 冒 號 分 隔 的 字 元 串 。

例 如 ， 要 將 ’clear’ 的 terminfo(5) 條 目 設 定 為 所 有 與 ’rxvt*’ 匹 配 的 終 端 型 別 的 ’\e[H\e[2J’ ， 請 執 行 以 下 操 作 ：

rxvt*:clear=\e[H\e[2J

終 端 條 目 值 在 解 釋 之 前 透 過 strunvis(3) 傳 遞 。

user-keys[] 快 捷 鍵

設 定 使 用 者 定 義 的 按 鍵 轉 義 序 列 列 表 。 每 個 專 案 都 與 一 個 名 為 ’User0’ 、 ’User1’ 等 的 按 鍵 相 關 聯 。

例 如 ：

set -s user-keys[0] "\e[5;30012~"
bind User0 resize-pane -L 3

可 用 的 會 話 選 項 是 ：

activity-action [any | none | current | other]

設 定 當 monitor-activity 開 啟 時 ， 視 窗 活 動 的 操 作 。 any 表 示 與 會 話 連 結 的 任 何 視 窗 的 活 動 都 會 在 該 會 話 的 當 前 視 窗 中 觸 發 響 鈴 或 訊 息 （ 取 決 於 visual-activity ） ， none 表 示 忽 略 所 有 活 動 （ 等 價 於 關 閉 monitor-activity ） ， current 表 示 僅 忽 略 當 前 視 窗 以 外 的 視 窗 中 的 活 動 ， other 表 示 忽 略 當 前 視 窗 中 的 活 動 ， 但 不 忽 略 其 他 視 窗 中 的 活 動 。

assume-paste-time 毫 秒

如 果 按 鍵 的 輸 入 速 度 快 於 毫 秒 ， 則 假 定 它 們 是 貼 上 而 不 是 鍵 入 ， 並 且 不 會 處 理 tmux 鍵 繫 結 。 預 設 值 為 一 毫 秒 ， 零 表 示 禁 用 此 功 能 。

base-index 索 引

設 定 建 立 新 視 窗 時 應 從 中 搜 索 未 使 用 索 引 的 基 本 索 引 。 預 設 值 為 零 。

bell-action [any | none | current | other]

設 定 當 monitor-bell 開 啟 時 ， 在 視 窗 中 響 鈴 的 操 作 。 這 些 值 與 activity-action 相 同 。

default-command 外 殼 命 令

將 新 視 窗 的 命 令 （ 如 果 在 建 立 視 窗 時 未 指 定 ） 設 定 為 外 殼 命 令 ， 它 可 以 是 任 何 sh(1) 命 令 。 預 設 值 為 空 字 串 ， 這 將 指 示 tmux 使 用 default-shell 選 項 的 值 建 立 登 入 外 殼 。

default-shell 路 徑

指 定 預 設 外 殼 。 當 default-command 選 項 設 定 為 空 時 ， 它 將 用 作 新 視 窗 的 登 入 外 殼 ， 並 且 必 須 是 可 執 行 檔 案 的 完 整 路 徑 。 在 啟 動 時 ， tmux 嘗 試 從 SHELL 環 境 變 數 、 getpwuid(3) 返 回 的 外 殼 或 /bin/sh 中 選 擇 適 當 的 第 一 個 值 作 為 預 設 值 。 當 tmux 用 作 登 入 外 殼 時 ， 應 配 置 此 選 項 。

default-size XxY

設 定 當 window-size 選 項 設 定 為 manual 或 使 用 new-session -d 建 立 會 話 時 ， 新 視 窗 的 預 設 大 小 。 該 值 為 寬 度 和 高 度 ， 由 ’x’ 字 元 分 隔 。 預 設 值 為 80x24。

destroy-unattached [on | off]

如 果 啟 用 並 且 會 話 不 再 附 加 到 任 何 客 戶 端 ， 它 將 被 銷 燬 。

detach-on-destroy [off | on | no-detached]

如 果 為 on（ 預 設 值 ） ， 當 所 附 加 的 會 話 被 銷 燬 時 ， 客 戶 端 會 分 離 。 如 果 為 off， 則 將 客 戶 端 切 換 到 剩 餘 會 話 中 最 近 活 動 的 會 話 。 如 果 為 no-detached ， 僅 在 不 存 在 分 離 的 會 話 時 分 離 客 戶 端 ； 如 果 存 在 分 離 的 會 話 ， 則 將 客 戶 端 切 換 到 最 近 活 動 的 會 話 。

display-panes-active-colour 顏 色

設 定 display-panes 命 令 使 用 的 顏 色 以 顯 示 活 動 窗 格 的 指 示 器 。

display-panes-colour 顏 色

設 定 display-panes 命 令 使 用 的 顏 色 以 顯 示 非 活 動 窗 格 的 指 示 器 。

display-panes-time 時 間

設 定 display-panes 命 令 顯 示 的 指 示 器 出 現 的 時 間 （ 以 毫 秒 為 單 位 ） 。

display-time 時 間

設 定 狀 態 行 訊 息 和 其 他 螢 幕 指 示 器 顯 示 的 時 間 。 如 果 設 定 為 0， 則 訊 息 和 指 示 器 將 一 直 顯 示 ， 直 到 按 下 按 鍵 。 時 間 以 毫 秒 為 單 位 。

history-limit 行 數

設 定 視 窗 歷 史 記 錄 中 儲 存 的 最 大 行 數 。 此 設 定 僅 適 用 於 新 視 窗 - 現 有 視 窗 歷 史 記 錄 不 會 被 調 整 大 小 ， 並 保 留 它 們 建 立 時 的 限 制 。

key-table 快 捷 鍵 表

將 預 設 的 鍵 表 設 定 為 key-table ， 而 不 是 root 。

lock-after-time 數 字

在 數 字 秒 的 不 活 動 時 間 後 鎖 定 會 話 （ 類 似 於 lock-session 命 令 ） 。 預 設 值 為 不 鎖 定 （ 設 定 為 0） 。

lock-command 外 殼 命 令

在 鎖 定 每 個 客 戶 端 時 要 執 行 的 命 令 。 預 設 值 是 使 用 -np 執 行 lock(1) 。

message-command-style 樣 式

設 定 狀 態 行 訊 息 命 令 樣 式 。 這 用 於 在 命 令 模 式 下 使 用 vi(1) 鍵 的 命 令 提 示 符 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

message-style 樣 式

設 定 狀 態 行 訊 息 樣 式 。 這 用 於 訊 息 和 命 令 提 示 符 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

mouse [on | off]

如 果 為 on， 則 tmux 捕 獲 滑 鼠 並 允 許 將 滑 鼠 事 件 繫 結 為 鍵 繫 結 。 有 關 詳 細 資 訊 ， 請 參 閱 滑 鼠 支 援 部 分 。

prefix 快 捷 鍵

設 定 接 受 為 字 首 鍵 的 鍵 。 除 了 按 鍵 繫 結 下 描 述 的 標 準 鍵 之 外 ， prefix 還 可 以 設 定 為 特 殊 鍵 ’None’ ， 以 設 定 無 字 首 。

prefix2 快 捷 鍵

設 定 接 受 為 次 級 字 首 鍵 的 鍵 。 與 prefix 一 樣 ， prefix2 可 以 設 定 為 ’None’ 。

renumber-windows [on | off]

如 果 為 on， 在 會 話 中 關 閉 視 窗 時 ， 自 動 按 數 字 順 序 重 新 編 號 其 他 視 窗 。 如 果 已 設 定 base-index 選 項 ， 則 遵 循 此 選 項 。 如 果 為 off， 則 不 重 新 編 號 視 窗 。

repeat-time 時 間

允 許 在 指 定 的 時 間 毫 秒 內 連 續 輸 入 多 個 命 令 ， 而 無 需 再 次 按 下 字 首 鍵 （ 預 設 為 500 毫 秒 ） 。 可 以 在 使 用 -r 標 誌 繫 結 鍵 時 設 定 鍵 是 否 重 複 。 預 設 繫 結 到 resize-pane 命 令 的 鍵 啟 用 了 重 複 。

set-titles [on | off]

嘗 試 使 用 tsl 和 fsl terminfo(5) 條 目 （ 如 果 存 在 ） 設 定 客 戶 端 終 端 標 題 。 如 果 終 端 似 乎 是 xterm(1) ， tmux 會 自 動 將 這 些 設 定 為 \e]0;...\007 序 列 。 預 設 情 況 下 ， 此 選 項 處 於 關 閉 狀 態 。

set-titles-string 字 串

如 果 set-titles 開 啟 ， 則 用 於 設 定 客 戶 端 終 端 標 題 的 字 串 。 格 式 將 被 展 開 ， 請 參 閱 格 式 部 分 。

silence-action [any | none | current | other]

設 定 當 monitor-silence 開 啟 時 ， 在 視 窗 中 靜 音 的 操 作 。 這 些 值 與 activity-action 相 同 。

status [off | on | 2 | 3 | 4 | 5]

顯 示 或 隱 藏 狀 態 行 或 指 定 其 大 小 。 使 用 on 給 狀 態 行 一 行 高 度 ； 2, 3, 4 or 5 更 多 行 。

status-format[] 格 式

指 定 用 於 狀 態 行 每 一 行 的 格 式 。 預 設 從 下 面 的 各 個 狀 態 選 項 構 建 頂 部 狀 態 行 。

status-interval 間 隔

每 間 隔 秒 更 新 狀 態 行 。 預 設 情 況 下 ， 每 15 秒 更 新 一 次 。 設 定 為 零 會 禁 用 間 隔 重 繪 。

status-justify [left | centre | right | absolute-centre]

Set the position of the window list in the status line: left, centre or right. centre puts the window list in the relative centre of the available free space; absolute-centre uses the centre of the entire horizontal space.

status-keys [vi | emacs]

在 狀 態 行 中 使 用 類 似 於 vi 或 emacs 的 鍵 繫 結 ， 例 如 在 命 令 提 示 符 下 。 預 設 為 emacs， 除 非 設 定 了 VISUAL 或 EDITOR 環 境 變 量 ， 並 且 它 們 包 含 字 串 ’vi’ 。

status-left 字 串

在 狀 態 行 左 側 顯 示 字 串 （ 預 設 為 會 話 名 稱 ） 。 字 串 將 透 過 strftime(3) 進 行 轉 換 。 還 請 參 閱 格 式 和 樣 式 部 分 。

有 關 如 何 設 定 名 稱 和 標 題 的 詳 細 資 訊 ， 請 參 閱 名 稱 和 標 題 章 節 。

例 子 是 ：

#(sysctl vm.loadavg)
#[fg=yellow,bold]#(apm -l)%%#[default] [#S]

預 設 是 ’[#S] ’.

status-left-length 長 度

設 定 狀 態 行 左 側 元 件 的 最 大 length 。 預 設 值 為 10。

status-left-style 樣 式

設 定 狀 態 行 左 側 部 分 的 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

status-position [top | bottom]

設 定 狀 態 行 的 位 置 。

status-right 字 串

在 狀 態 行 右 側 顯 示 字 串 。 預 設 情 況 下 ， 顯 示 當 前 窗 格 標 題 （ 用 雙 引 號 括 起 來 ） 、 日 期 和 時 間 。 與 status-left 一 樣 ， 字 串 將 傳 遞 給 strftime(3) ， 並 替 換 字 元 對 。

status-right-length 長 度

設 定 狀 態 行 右 側 元 件 的 最 大 長 度 長 度 。 預 設 為 40。

status-right-style 樣 式

設 定 狀 態 行 右 側 部 分 的 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

status-style 樣 式

設 定 狀 態 行 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

update-environment[] 變 數

設 定 要 複 製 到 會 話 環 境 中 的 環 境 變 數 列 表 ， 當 建 立 新 會 話 或 附 加 現 有 會 話 時 使 用 。 任 何 在 源 環 境 中 不 存 在 的 變 數 都 將 被 設 定 為 從 會 話 環 境 中 刪 除 （ 就 像 對 set-environment 命 令 給 出 了 -r 一 樣 ） 。

visual-activity [on | off | both]

如 果 為 on， 則 在 啟 用 了 monitor-activity 視 窗 選 項 的 視 窗 中 發 生 活 動 時 ， 顯 示 訊 息 而 不 是 傳 送 響 鈴 。 如 果 設 定 為 both， 則 會 同 時 發 出 響 鈴 和 訊 息 。

visual-bell [on | off | both]

如 果 為 on， 則 在 啟 用 了 monitor-bell 窗 口 選 項 的 視 窗 中 ， 響 鈴 時 會 顯 示 訊 息 ， 而 不 是 將 其 傳 遞 到 終 端 （ 通 常 會 發 出 聲 音 ） 。 如 果 設 定 為 both， 則 會 同 時 發 出 響 鈴 和 訊 息 。 還 請 參 閱 bell-action 選 項 。

visual-silence [on | off | both]

如 果 啟 用 了 monitor-silence ， 則 在 給 定 視 窗 的 間 隔 過 期 後 列 印 訊 息 ， 而 不 是 傳 送 響 鈴 。 如 果 設 定 為 both， 則 會 同 時 發 出 響 鈴 和 訊 息 。

word-separators 字 串

為 會 話 設 定 哪 些 字 元 被 視 為 單 詞 分 隔 符 ， 以 便 在 複 製 模 式 下 使 用 下 一 個 和 上 一 個 單 詞 命 令 。

可 用 的 視 窗 選 項 是 ：

aggressive-resize [on | off]

強 制 調 整 所 選 視 窗 的 大 小 。 這 意 味 著 tmux 將 調 整 視 窗 大 小 為 最 小 或 最 大 會 話 的 大 小 （ 請 參 閱 window-size 選 項 ） ， 而 不 是 所 附 加 的 會 話 。 當 在 另 一 個 會 話 中 更 改 當 前 視 窗 時 ， 視 窗 可 能 會 被 調 整 大 小 ； 此 選 項 適 用 於 支 援 SIGWINCH 的 全 屏 程 式 ， 但 不 適 用 於 諸 如 shell 之 類 的 互 動 式 程 式 。

automatic-rename [on | off]

控 制 視 窗 自 動 重 新 命 名 。 啟 用 此 設 定 時 ， tmux 將 使 用 由 automatic-rename-format 指 定 的 格 式 自 動 重 新 命 名 視 窗 。 當 使 用 new-window 或 new-session 建 立 視 窗 時 ， 或 稍 後 使 用 rename-window 或 終 端 轉 義 序 列 指 定 名 稱 時 ， 此 標 誌 會 自 動 禁 用 單 個 視 窗 的 重 新 命 名 。 可 以 使 用 以 下 方 式 全 局 關 閉 它 ：

set-option -wg automatic-rename off

automatic-rename-format 格 式

啟 用 automatic-rename 選 項 時 使 用 的 格 式 （ 請 參 閱 格 式 ） 。

clock-mode-colour 顏 色

設 定 時 鐘 顏 色 。

clock-mode-style [12 | 24]

設 定 時 鐘 小 時 格 式 。

fill-character 字 元

設 定 用 於 填 充 視 窗 未 使 用 的 終 端 區 域 的 字 元 。

main-pane-height 高 度
main-pane-width 寬 度

設 定 main-horizontal 或 main-vertical 佈 局 中 主 要 （ 左 側 或 頂 部 ） 窗 格 的 寬 度 或 高 度 。 如 果 字 尾 為 ’%’ ， 則 這 是 視 窗 大 小 的 百 分 比 。

copy-mode-match-style 樣 式

在 複 製 模 式 下 設 定 搜 尋 匹 配 的 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

copy-mode-mark-style 樣 式

設 定 複 製 模 式 下 包 含 標 記 的 行 的 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 部 分 。

copy-mode-current-match-style 樣 式

在 複 製 模 式 下 設 定 當 前 搜 尋 匹 配 的 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

mode-keys [vi | emacs]

在 複 製 模 式 下 使 用 vi 或 emacs 風 格 的 鍵 繫 結 。 預 設 為 emacs， 除 非 VISUAL 或 EDITOR 包 含 ’vi’ 。

mode-style 樣 式

設 定 視 窗 模 式 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

monitor-activity [on | off]

監 視 視 窗 中 的 活 動 。 有 活 動 的 視 窗 在 狀 態 行 中 會 有 突 出 顯 示 。

monitor-bell [on | off]

監 視 視 窗 中 的 響 鈴 。 有 響 鈴 的 視 窗 在 狀 態 行 中 會 有 突 出 顯 示 。

monitor-silence [interval]

在 interval 秒 內 監 視 視 窗 中 的 靜 默 （ 無 活 動 ） 。 在 此 時 間 段 內 保 持 靜 默 的 視 窗 在 狀 態 行 中 會 有 突 出 顯 示 。 間 隔 為 零 會 禁 用 監 視 。

other-pane-height 高 度

設 定 main-horizontal 佈 局 中 其 他 窗 格 （ 不 是 主 窗 格 ） 的 高 度 。 如 果 將 此 選 項 設 定 為 0（ 預 設 值 ） ， 則 不 會 產 生 任 何 效 果 。 如 果 同 時 設 定 了 main-pane-height 和 other-pane-height 選 項 ， 則 主 窗 格 會 變 得 更 高 ， 以 使 其 他 窗 格 達 到 指 定 的 高 度 ， 但 不 會 縮 小 。 如 果 字 尾 為 ’%’ ， 則 這 是 視 窗 大 小 的 百 分 比 。

other-pane-width 寬 度

與 other-pane-height 類 似 ， 但 設 定 main-vertical 佈 局 中 其 他 窗 格 的 寬 度 。

pane-active-border-style 樣 式

為 當 前 活 動 的 窗 格 設 定 窗 格 邊 框 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。 屬 性 被 忽 略 。

pane-base-index 索 引

與 base-index 類 似 ， 但 設 定 窗 格 編 號 的 起 始 索 引 。

pane-border-format 格 式

設 定 窗 格 邊 框 狀 態 行 中 顯 示 的 文 字 。

pane-border-indicators [off | colour | arrows | both]

在 僅 具 有 兩 個 窗 格 的 視 窗 中 ， 僅 對 邊 框 的 一 半 上 色 、 顯 示 箭 頭 標 記 、 繪 製 兩 者 或 都 不 繪 製 ， 以 指 示 活 動 窗 格 。

pane-border-lines 型 別

設 定 用 於 繪 製 窗 格 邊 框 的 字 元 型 別 。 type 可 能 是 以 下 之 一 ：

single

使 用 ACS 或 UTF-8 字 元 的 單 行

double

使 用 UTF-8 字 元 的 雙 行

heavy

使 用 UTF-8 字 元 的 粗 線

simple

簡 單 的 ASCII 字 元

number

窗 格 編 號

當 不 支 援 UTF-8 時 ， ’double’ 和 ’heavy’ 將 回 退 到 標 準 的 ACS 線 條 繪 制 。

pane-border-status [off | top | bottom]

關 閉 面 板 邊 框 狀 態 行 或 設 定 其 位 置 。

pane-border-style 樣 式

為 活 動 窗 格 之 外 的 窗 格 設 定 窗 格 邊 框 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。 屬 性 被 忽 略 。

popup-style 樣 式

設 定 彈 出 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。 屬 性 被 忽 略 。

popup-border-style 樣 式

設 定 彈 出 邊 框 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。 屬 性 被 忽 略 。

popup-border-lines 型 別

設 定 用 於 繪 製 彈 出 邊 框 的 字 元 型 別 。 type 可 能 是 以 下 之 一 ：

single

使 用 ACS 或 UTF-8 字 元 的 單 行 （ 預 設 ）

rounded

使 用 UTF-8 字 元 的 圓 角 單 變 體

double

使 用 UTF-8 字 元 的 雙 行

heavy

使 用 UTF-8 字 元 的 粗 線

simple

簡 單 的 ASCII 字 元

padded

簡 單 的 ASCII 空 格 字 元

none

無 邊 界

當 不 支 援 UTF-8 時 ， ’double’ 和 ’heavy’ 將 回 退 到 標 準 的 ACS 線 條 繪 制 。

window-status-activity-style 樣 式

設 定 具 有 活 動 警 報 的 視 窗 的 狀 態 行 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 部 分 。

window-status-bell-style 樣 式

為 帶 有 鈴 鐺 警 報 的 視 窗 設 定 狀 態 行 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

window-status-current-format 字 串

類 似 於 window-status-format ， 但 它 是 當 前 視 窗 時 使 用 的 格 式 。

window-status-current-style 樣 式

為 當 前 活 動 視 窗 設 定 狀 態 行 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

window-status-format 字 串

設 定 視 窗 在 狀 態 行 視 窗 列 表 中 顯 示 的 格 式 。 請 參 閱 格 式 和 樣 式 部 分 。

window-status-last-style 樣 式

為 最 後 一 個 活 動 視 窗 設 定 狀 態 行 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

window-status-separator 字 串

設 定 狀 態 行 中 視 窗 之 間 繪 製 的 分 隔 符 。 預 設 是 單 個 空 格 字 元 。

window-status-style 樣 式

為 單 個 視 窗 設 定 狀 態 行 樣 式 。 對 於 如 何 指 定 樣 式 ， 參 見 樣 式 節 。

window-size largest | smallest | manual | latest

配 置 tmux 如 何 確 定 視 窗 大 小 。 如 果 設 定 為 largest ， 則 使 用 最 大 附 加 會 話 的 大 小 ； 如 果 設 定 為 smallest ， 則 使 用 最 小 附 加 會 話 的 大 小 。 如 果 設 定 為 manual ， 則 從 default-size 選 項 設 定 新 視 窗 的 大 小 ， 並 自 動 調 整 視 窗 大 小 。 使 用 latest ， tmux 使 用 最 近 活 動 的 客 戶 端 的 大 小 。 另 請 參 閱 resize-window 命 令 和 aggressive-resize 選 項 。

wrap-search [on | off]

如 果 設 定 了 此 選 項 ， 則 搜 尋 將 繞 過 面 板 內 容 的 末 尾 。 預 設 值 為 on 。

可 用 的 窗 格 選 項 是 ：

allow-passthrough [on | off]

允 許 面 板 中 的 程 式 使 用 終 端 轉 義 序 列 (\ePtmux;...\e\\) 繞 過 tmux 。

allow-rename [on | off]

允 許 面 板 中 的 程 式 使 用 終 端 轉 義 序 列 (\ek...\e\\) 更 改 視 窗 名 稱 。

alternate-screen [on | off]

此 選 項 配 置 是 否 允 許 在 面 板 內 執 行 的 程 式 使 用 終 端 備 用 屏 幕 功 能 ， 該 功 能 允 許 使 用 smcup 和 rmcup terminfo(5) 功 能 。 備 用 螢 幕 功 能 在 互 動 式 應 用 程 式 啟 動 時 保 留 視 窗 的 內 容 ， 並 在 退 出 時 恢 復 它 ， 以 便 在 應 用 程 序 啟 動 之 前 可 見 的 任 何 輸 出 在 退 出 後 重 新 出 現 ， 而 不 會 改 變 。

cursor-colour 顏 色

設 定 游 標 的 顏 色 。

pane-colours[] 顏 色

預 設 的 顏 色 調 色 盤 。 陣 列 中 的 每 個 條 目 定 義 了 當 請 求 具 有 該 索 引 的 顏 色 時 tmux 使 用 的 顏 色 。 索 引 可 以 從 零 到 255。

cursor-style 樣 式

設 定 游 標 的 樣 式 。 可 用 的 樣 式 有 ： default ， blinking-block ， block ， blinking-underline ， underline ， blinking-bar ， bar 。

remain-on-exit [on | off | failed]

設 定 此 標 誌 的 面 板 在 其 中 執 行 的 程 式 退 出 時 不 會 被 銷 燬 。 如 果 設 定 為 failed ， 則 僅 當 程 式 的 退 出 狀 態 不 為 零 時 。 可 以 使 用 respawn-pane 命 令 重 新 啟 用 面 板 。

remain-on-exit-format 字 串

當 啟 用 remain-on-exit 時 ， 設 定 退 出 窗 格 底 部 顯 示 的 文 字 。

scroll-on-clear [on | off]

當 清 除 整 個 螢 幕 並 啟 用 此 選 項 時 ， 在 清 除 螢 幕 之 前 將 螢 幕 內 容 滾 動 到 歷 史 記 錄 中 。

synchronize-panes [on | off]

將 輸 入 複 製 到 同 一 視 窗 中 所 有 其 他 啟 用 此 選 項 的 面 板 中 （ 僅 適 用 於 未 處 於 任 何 模 式 的 面 板 ） 。

window-active-style 樣 式

當 它 是 活 動 窗 格 時 設 定 窗 格 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

window-style 樣 式

設 定 窗 格 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

鉤 子

tmux 允 許 在 各 種 觸 發 器 （ 稱 為 鉤 子 ） 上 執 行 命 令 。 大 多 數 tmux 命 令 都 有 一 個 after 鉤 子 ， 並 且 有 許 多 與 命 令 無 關 的 鉤 子 。

Hooks被 儲 存 為 陣 列 選 項 ， 當 觸 發 hook時 ， 陣 列 成 員 按 順 序 執 行 。 與 選 項 一 樣 ， 不 同 的 hook可 能 是 全 域 性 的 或 屬 於 會 話 、 視 窗 或 面 板 。 可 以 使 用 set-hook 或 set-option 命 令 配 置 hooks， 並 使 用 show-hooks 或 show-options -H 顯 示 。 以 下 兩 個 命 令 是 等 效 的 ：

set-hook -g pane-mode-changed[42] ’set -g status-left-style bg=red’
set-option -g pane-mode-changed[42] ’set -g status-left-style bg=red’

在 不 指 定 陣 列 索 引 的 情 況 下 設 定 掛 鉤 會 清 除 掛 鉤 並 設 定 陣 列 的 第 一 個 成 員 。

命 令 的 後 鉤 子 在 它 完 成 後 執 行 ， 除 非 該 命 令 作 為 鉤 子 本 身 的 一 部 分 執 行 。 它 們 以 ’after-’ 字 首 命 名 。 例 如 ， 以 下 命 令 在 每 次 split-window 之 後 添 加 了 一 個 鉤 子 來 選 擇 even-vertical 佈 局 ：

set-hook -g after-split-window "selectl even-vertical"

控 制 方 式 部 分 列 出 的 所 有 通 知 都 是 鉤 子 （ 不 帶 任 何 引 數 ） ， 除 了 %exit 。 還 提 供 了 以 下 其 他 鉤 子 ：

alert-activity

當 視 窗 有 活 動 時 執 行 。 參 見 monitor-activity 。

alert-bell

當 視 窗 收 到 鈴 聲 時 執 行 。 參 見 monitor-bell 。

alert-silence

當 視 窗 靜 音 時 執 行 。 參 見 monitor-silence 。

client-active

當 客 戶 端 成 為 其 會 話 的 最 新 活 動 客 戶 端 時 執 行 。

client-attached

連 線 客 戶 端 時 執 行 。

client-detached

在 客 戶 端 分 離 時 執 行

client-focus-in

當 焦 點 進 入 客 戶 端 時 執 行

client-focus-out

當 焦 點 退 出 客 戶 端 時 執 行

client-resized

在 調 整 客 戶 端 大 小 時 執 行 。

client-session-changed

當 客 戶 端 的 附 加 會 話 更 改 時 執 行 。

pane-died

當 窗 格 中 執 行 的 程 式 退 出 時 執 行 ， 但 remain-on-exit 處 於 開 啟 狀 態 ， 因 此 窗 格 尚 未 關 閉 。

pane-exited

當 窗 格 中 執 行 的 程 式 退 出 時 執 行 。

pane-focus-in

如 果 打 開 了 focus-events 選 項 ， 則 在 焦 點 進 入 窗 格 時 執 行 。

pane-focus-out

如 果 打 開 了 focus-events 選 項 ， 則 在 焦 點 離 開 窗 格 時 執 行 。

pane-set-clipboard

當 使 用 xterm(1) 轉 義 序 列 設 定 終 端 剪 貼 簿 時 執 行 。

session-created

在 建 立 新 會 話 時 執 行 。

session-closed

在 會 話 關 閉 時 執 行 。

session-renamed

在 重 新 命 名 會 話 時 執 行 。

window-linked

當 視 窗 連 結 到 會 話 時 執 行 。

window-renamed

在 重 新 命 名 視 窗 時 執 行 。

window-resized

在 調 整 視 窗 大 小 時 執 行 。 這 可 能 是 在 執 行 client-resized 掛 鉤 之 後 。

window-unlinked

當 視 窗 與 會 話 斷 開 連 結 時 執 行 。

使 用 以 下 命 令 管 理 鉤 子 ：

set-hook [-agpRuw] [-t 目 標 窗 格 ] 鉤 子 名 稱 命 令

如 果 沒 有 -R ， 則 將 鉤 子 鉤 子 名 稱 設 定 為 命 令 （ 或 使 用 -u 取 消 設 定 ） 。 標 誌 與 set-option 相 同 。

使 用 -R ， 立 即 執 行 鉤 子 名 稱 。

show-hooks [-gpw] [-t 目 標 窗 格 ]

顯 示 鉤 子 。 標 誌 與 show-options 相 同 。

滑 鼠 支 援

如 果 打 開 了 mouse 選 項 （ 預 設 為 關 閉 狀 態 ） ， tmux 允 許 將 滑 鼠 事 件 繫 結 為 按 鍵 。 每 個 鍵 的 名 稱 由 滑 鼠 事 件 （ 例 如 ’MouseUp1’ ） 和 位 置 字 尾 之 一 組 成 ， 位 置 後 綴 可 以 是 以 下 之 一 ：

Pane 窗 格 內 容
Border 窗 格 邊 框
Status 狀 態 行 視 窗 列 表
StatusLeft 狀 態 行 的 左 側 部 分
StatusRight 狀 態 行 的 右 邊 部 分
StatusDefault 狀 態 行 的 任 何 其 他 部 分

以 下 滑 鼠 事 件 可 用 ：

WheelUp WheelDown
MouseDown1 MouseUp1 MouseDrag1 MouseDragEnd1
MouseDown2 MouseUp2 MouseDrag2 MouseDragEnd2
MouseDown3 MouseUp3 MouseDrag3 MouseDragEnd3
SecondClick1 SecondClick2 SecondClick3
DoubleClick1 DoubleClick2 DoubleClick3
TripleClick1 TripleClick2 TripleClick3

’SecondClick’ 事 件 在 雙 擊 的 第 二 次 單 擊 時 觸 發 ， 即 使 可 能 有 第 三 次 單 擊 ， 也 會 觸 發 ’TripleClick’ 而 不 是 ’DoubleClick’ 。

每 個 都 應 該 以 一 個 位 置 作 為 字 尾 ， 例 如 ’MouseDown1Status’ 。

在 繫 結 到 滑 鼠 按 鍵 的 命 令 中 ， 可 以 使 用 特 殊 的 令 牌 ’{mouse}’ 或 ’=’ 作 為 目 標 視 窗 或 目 標 窗 格 。 它 解 析 為 滑 鼠 事 件 發 生 的 視 窗 或 面 板 （ 例 如 ， 在 狀 態 行 中 釋 放 按 鈕 1的 視 窗 ， 用 於 ’MouseUp1Status’ 繫 結 ， 或 在 滾 動 輪 下 滾 動 的 面 板 ， 用 於 ’WheelDownPane’ 繫 結 ） 。

可 以 使 用 send-keys -M 標 誌 將 滑 鼠 事 件 轉 發 到 窗 格 。

預 設 的 鍵 繫 結 允 許 使 用 滑 鼠 選 擇 和 調 整 窗 格 大 小 ， 複 製 文 字 以 及 使 用 狀 態 列 更 改 視 窗 。 如 果 打 開 了 mouse 選 項 ， 則 這 些 繫 結 生 效 。

格 式

某 些 命 令 接 受 帶 有 -F 標 誌 和 格 式 引 數 。 這 是 一 個 字 串 ， 用 於 控 制 命 令 的 輸 出 格 式 。 格 式 變 數 用 ’#{’ 和 ’}’ 括 起 來 ， 例 如 ’#{session_name}’ 。 可 能 的 變 數 在 下 表 中 列 出 ， 或 者 可 以 使 用 tmux 選 項 的 名 稱 作 為 選 項 的 值 。 一 些 變 數 有 一 個 更 短 的 別 名 ， 例 如 ’#S’ ； ’##’ 被 替 換 為 單 個 ’#’ ， ’#,’ 被 替 換 為 ’,’ ， ’#}’ 被 替 換 為 ’}’ 。

可 以 透 過 字 首 ’?’ 並 使 用 逗 號 分 隔 兩 個 備 選 項 來 使 用 條 件 語 句 ； 如 果 指 定 的 變 數 存 在 且 不 為 零 ， 則 選 擇 第 一 個 備 選 項 ， 否 則 使 用 第 二 個 。 例 如 ， ’#{?session_attached,attached,not attached}’ 將 包 括 字 串 ’attached’ 如 果 會 話 已 連 線 ， 包 括 字 串 ’not attached’ 如 果 會 話 未 連 線 ， 或 者 ’#{?automatic-rename,yes,no}’ 將 包 括 ’yes’ 如 果 automatic-rename 已 啟 用 ， 否 則 包 括 ’no’ 。 條 件 語 句 可 以 任 意 巢 狀 。 在 條 件 語 句 內 部 ， ’,’ 和 ’}’ 必 須 轉 義 為 ’#,’ 和 ’#}’ ， 除 非 它 們 是 ’#{...}’ 替 換 的 一 部 分 。 例 如 ：

#{?pane_in_mode,#[fg=white#,bg=red],#[fg=red#,bg=white]}#W .

字 串 比 較 可 以 透 過 在 兩 個 逗 號 分 隔 的 備 選 項 字 首 ’==’ ， ’!=’ ， ’<’ ， ’>’ ， ’<=’ 或 ’>=’ 和 冒 號 來 表 示 。 例 如 ， ’#{==:#{host},myhost}’ 將 被 替 換 為 ’1’ 如 果 在 ’myhost’ 上 執 行 ， 否 則 替 換 為 ’0’ 。 ’||’ 和 ’&&’ 如 果 兩 個 逗 號 分 隔 的 備 選 項 中 有 一 個 或 兩 個 都 為 真 ， 則 計 算 為 真 ， 例 如 ’#{||:#{pane_in_mode},#{alternate_on}}’ 。

’m’ 指 定 fnmatch(3) 或 正 則 表 示 式 比 較 。 第 一 個 引 數 是 模 式 ， 第 二 個 是 要 比 較 的 字 串 。 一 個 可 選 的 引 數 指 定 標 誌 ： ’r’ 表 示 模 式 是 一 個 正 則 表 示 式 ， 而 不 是 預 設 的 fnmatch(3) 模 式 ， ’i’ 表 示 忽 略 大 小 寫 。 例 如 ： ’#{m:*foo*,#{host}}’ 或 ’#{m/ri:^A,MYVAR}’ 。 ’C’ 在 窗 格 內 容 中 執 行 fnmatch(3) 模 式 或 正 則 表 示 式 搜 尋 ， 並 在 未 找 到 時 計 算 為 零 ， 或 在 找 到 時 計 算 為 行 號 。 與 ’m’ 一 樣 ， ’r’ 標 誌 表 示 搜 尋 正 則 表 示 式 ， ’i’ 忽 略 大 小 寫 。 例 如 ： ’#{C/r:^Start}’ 。

可 以 透 過 在 兩 個 逗 號 分 隔 的 備 選 項 前 面 加 上 ’e’ 和 運 算 子 來 執 行 數 字 運 算 。 運 算 符 後 面 可 以 給 出 一 個 可 選 的 ’f’ 標 誌 ， 以 使 用 浮 點 數 ， 否 則 使 用 整 數 。 這 可 以 後 跟 一 個 數 字 ， 給 出 要 用 於 結 果 的 小 數 位 數 。 可 用 的 運 算 子 有 ： 加 法 ’+’ ， 減 法 ’-’ ， 乘 法 ’*’ ， 除 法 ’/’ ， 模 數 ’m’ 或 ’%’ （ 請 注 意 ， 在 同 時 由 strftime(3) 展 開 的 格 式 中 ， ’%%%’ 必 須 轉 義 為 ’%%%’ ） ， 以 及 數 字 比 較 運 算 子 ’==’ 、 ’!=’ 、 ’<’ 、 ’<=’ 、 ’>’ 和 ’>=’ 。 例 如 ， ’#{e|*|f|4:5.5,3}’ 將 5.5 乘 以 3， 得 到 四 位 小 數 的 結 果 ， ’#{e|%%%:7,3}’ 返 回 7 和 3 的 模 數 。 ’a’ 用 其 ASCII 碼 替 換 數 字 引 數 ， 因 此 ’#{a:98}’ 的 結 果 是 ’b’ 。 ’c’ 將 tmux 顏 色 替 換 為 它 的 六 位 十 六 進 位 制 RGB 值 。

可 以 透 過 在 字 串 字 首 新 增 ’=’ 、 一 個 數 字 和 一 個 冒 號 來 限 制 結 果 字 串 的 長 度 。 正 數 從 字 串 的 開 頭 計 數 ， 負 數 從 末 尾 計 數 ， 因 此 ’#{=5:pand_title}’ 將 包 括 窗 格 標 題 的 最 多 前 五 個 字 元 ， 或 者 ’#{=-5:pand_title}’ 將 包 括 最 後 五 個 字 元 。 第 二 個 引 數 可 以 給 出 字 尾 或 字 首 - 如 果 提 供 ， 則 在 剪 裁 長 度 後 將 其 附 加 或 前 置 到 字 串 中 ， 例 如 ’#{=/5/...:pand_title}’ 如 果 窗 格 標 題 超 過 五 個 字 元 ， 則 會 附 加 ’...’ 。 同 樣 ， ’p’ 將 字 串 填 充 到 給 定 的 寬 度 ， 例 如 ’#{p10:pand_title}’ 將 產 生 至 少 10 個 字 元 的 寬 度 。 正 寬 度 在 左 側 填 充 ， 負 寬 度 在 右 側 填 充 。 ’n’ 展 開 為 變 數 的 長 度 ， ’w’ 展 開 為 其 顯 示 時 的 寬 度 ， 例 如 ’#{n:window_name}’ 。

在 時 間 變 數 前 加 上 ’t:’ 將 其 轉 換 為 字 串 ， 因 此 如 果 ’#{window_activity}’ 給 出 ’1445765102’ ， ’#{t:window_activity}’ 將 給 出 ’Sun Oct 25 09:25:02 2015’ 。 新 增 ’p (’ ’’t/p’’) 將 使 用 較 短 但 不 太 準 確 的 時 間 格 式 來 表 示 過 去 的 時 間 。 可 以 使 用 ’f’ 字 尾 指 定 自 定 義 格 式 （ 請 注 意 ， 如 果 格 式 單 獨 透 過 strftime(3) 傳 遞 ， ’%’ 必 須 轉 義 為 ’%%%’ ， 例 如 在 status-left 選 項 中 ） ： ’#{t/f/%%%H#:%%%M:window_activity}’ ， 參 見 strftime(3) 。

’b:’ 和 ’d:’ 字 首 分 別 是 變 數 的 basename(3) 和 dirname(3) 。 ’q:’ 將 轉 義 sh(1) 特 殊 字 元 ， 或 使 用 ’h’ 字 尾 轉 義 井 號 字 元 （ 因 此 ’#’ 變 成 ’##’ ） 。 ’E:’ 將 兩 次 擴 充 套 件 格 式 ， 例 如 ’#{E:status-left}’ 是 擴 充 套 件 status-left 選 項 的 內 容 而 不 是 選 項 本 身 的 結 果 。 ’T:’ 類 似 於 ’E:’ ， 但 還 會 擴 充 套 件 strftime(3) 格 式 說 明 符 。 ’S:’ 、 ’W:’ 或 ’P:’ 將 迴 圈 遍 歷 每 個 會 話 、 視 窗 或 面 板 ， 併 為 每 個 插 入 格 式 。 對 於 窗 口 和 麵 板 ， 可 以 給 出 兩 個 逗 號 分 隔 的 格 式 ： 第 二 個 格 式 用 於 當 前 視 窗 或 活 動 面 板 。 例 如 ， 要 獲 得 一 個 類 似 於 狀 態 行 格 式 化 的 視 窗 列 表 ：

#{W:#{E:window-status-format} ,#{E:window-status-current-format} }

’N:’ 檢 查 視 窗 （ 沒 有 任 何 字 尾 或 帶 有 ’w’ 字 尾 ） 或 會 話 （ 帶 有 ’s’ 字 尾 ） 名 稱 是 否 存 在 ， 例 如 ’’N/w:foo’’ 如 果 存 在 名 為 ’foo’ 的 視 窗 ， 則 替 換 為 1。

形 式 為 ’s/foo/bar/:’ 的 字 首 將 在 整 個 文 字 中 將 ’foo’ 替 換 為 ’bar’ 。 第 一 個 引 數 可 以 是 擴 充 套 件 正 則 表 示 式 ， 最 後 一 個 引 數 可 以 是 ’i’ 以 忽 略 大 小 寫 ， 例 如 ’s/a(.)/\1x/i:’ 將 把 ’abABab’ 改 為 ’bxBxbx’ 。

此 外 ， 可 以 使 用 ’#()’ 將 shell 命 令 的 輸 出 的 最 後 一 行 插 入 到 格 式 中 。 例 如 ， ’#(uptime)’ 將 插 入 系 統 的 正 常 執 行 時 間 。 在 構 造 格 式 時 ， tmux 不 等 待 ’#()’ 命 令 完 成 ； 相 反 ， 使 用 執 行 相 同 命 令 的 上 一 個 結 果 ， 或 者 如 果 命 令 之 前 沒 有 執 行 ， 則 使 用 佔 位 符 。 如 果 命 令 尚 未 退 出 ， 則 使 用 輸 出 中 最 近 的 一 行 ， 但 是 狀 態 行 不 會 更 新 超 過 一 秒 鐘 。 使 用 /bin/sh 執 行 命 令 ， 並 使 用 tmux 全 域 性 環 境 設 定 （ 請 參 見 全 域 性 和 會 話 環 境 部 分 ） 。

’l’ 指 定 字 串 應 該 按 字 面 意 義 解 釋 而 不 是 擴 充 套 件 。 例 如 ， ’#{l:#{?pane_in_mode,yes,no}}’ 將 被 替 換 為 ’#{?pane_in_mode,yes,no}’ 。

在 適 當 的 情 況 下 ， 可 以 使 用 以 下 變 數 ：

變 數 名 別 名 替 換 為
active_window_index 會 話 中 活 動 視 窗 的 索 引
alternate_on 如 果 窗 格 在 備 用 螢 幕 中 則 為 1
alternate_saved_x 在 備 用 螢 幕 中 儲 存 游 標 X
alternate_saved_y 在 備 用 螢 幕 中 儲 存 游 標 Y
buffer_created 緩 衝 區 建 立 時 間
buffer_name 緩 衝 區 名 稱
buffer_sample 緩 衝 區 開 始 的 樣 本
buffer_size 指 定 緩 衝 區 的 大 小 （ 以 位 元 組 為 單 位 ）
client_activity 客 戶 端 上 次 活 動 的 時 間
client_cell_height 每 個 客 戶 單 元 格 的 高 度 （ 以 畫 素 為 單 位 ）
client_cell_width 每 個 客 戶 單 元 格 的 寬 度 （ 以 畫 素 為 單 位 ）
client_control_mode 如 果 客 戶 端 處 於 控 制 模 式 則 為 1
client_created 客 戶 端 建 立 時 間
client_discarded 客 戶 端 落 後 時 丟 棄 的 位 元 組
client_flags 客 戶 端 標 誌 列 表
client_height 客 戶 端 高 度
client_key_table 當 前 快 捷 鍵 表
client_last_session 客 戶 端 上 次 會 話 的 名 稱
client_name 客 戶 端 名 稱
client_pid 客 戶 端 程 序 代 號
client_prefix 如 果 按 下 了 字 首 鍵 則 為 1
client_readonly 如 果 客 戶 端 只 讀 則 為 1
client_session 客 戶 端 會 話 的 名 稱
client_termfeatures 客 戶 端 的 終 端 功 能 （ 如 果 有 ）
client_termname 客 戶 端 終 端 名 稱
client_termtype 客 戶 端 的 終 端 型 別 （ 如 果 可 用 ）
client_tty 客 戶 端 的 偽 終 端
client_uid 客 戶 端 程 序 的 使 用 者 代 號
client_user 客 戶 端 程 序 的 使 用 者
client_utf8 如 果 客 戶 端 支 援 UTF-8 則 為 1
client_width 客 戶 端 寬 度
client_written 寫 入 客 戶 端 的 位 元 組
command 正 在 使 用 的 命 令 的 名 稱 （ 如 果 有 ）
command_list_alias 列 出 命 令 時 的 命 令 別 名
command_list_name 列 出 命 令 時 的 命 令 名 稱
command_list_usage 列 出 命 令 時 的 命 令 用 法
config_files 載 入 的 配 置 檔 案 列 表
copy_cursor_line 複 製 模 式 下 游 標 所 在 的 行
copy_cursor_word 複 製 模 式 下 游 標 下 的 單 詞
copy_cursor_x 複 製 模 式 下 的 游 標 X 位 置
copy_cursor_y 複 製 模 式 下 的 游 標 Y 位 置
current_file 當 前 配 置 檔 案
cursor_character 窗 格 中 游 標 處 的 字 元
cursor_flag 窗 格 游 標 標 誌
cursor_x 游 標 在 窗 格 中 的 X 位 置
cursor_y 游 標 在 窗 格 中 的 Y 位 置
history_bytes 視 窗 歷 史 記 錄 中 的 位 元 組 數
history_limit 最 大 視 窗 歷 史 記 錄 行
history_size 歷 史 行 的 大 小
hook 執 行 鉤 子 的 名 稱 （ 如 果 有 ）
hook_client 執 行 掛 鉤 的 客 戶 端 的 名 稱 （ 如 果 有 ）
hook_pane 執 行 掛 鉤 的 窗 格 代 號 （ 如 果 有 ）
hook_session 執 行 掛 鉤 的 會 話 代 號 （ 如 果 有 ）
hook_session_name 執 行 鉤 子 的 會 話 的 名 稱 （ 如 果 有 ）
hook_window 執 行 掛 鉤 的 視 窗 的 ID（ 如 果 有 ）
hook_window_name 執 行 鉤 子 的 視 窗 的 名 稱 （ 如 果 有 ）
host #H 本 地 主 機 的 主 機 名
host_short #h 本 地 主 機 的 主 機 名 （ 無 域 名 ）
insert_flag 窗 格 插 入 標 誌
keypad_cursor_flag 窗 格 鍵 盤 游 標 標 誌
keypad_flag 窗 格 鍵 盤 標 誌
last_window_index 會 話 中 最 後 一 個 視 窗 的 索 引
line 列 表 中 的 行 號
mouse_all_flag 窗 格 滑 鼠 所 有 標 誌
mouse_any_flag 窗 格 滑 鼠 任 何 標 誌
mouse_button_flag 窗 格 滑 鼠 按 鈕 標 誌
mouse_line 滑 鼠 下 的 線 （ 如 果 有 ）
mouse_sgr_flag 窗 格 滑 鼠 SGR 標 誌
mouse_standard_flag 窗 格 滑 鼠 標 準 標 誌
mouse_utf8_flag 窗 格 滑 鼠 UTF-8 標 誌
mouse_word 滑 鼠 下 的 單 詞 （ 如 果 有 ）
mouse_x 滑 鼠 X 位 置 （ 如 果 有 ）
mouse_y 滑 鼠 Y 位 置 （ 如 果 有 ）
next_session_id 下 一 個 新 會 話 的 唯 一 會 話 代 號
origin_flag 窗 格 起 源 標 誌
pane_active 如 果 活 躍 窗 格 則 為 1
pane_at_bottom 如 果 窗 格 位 於 視 窗 底 部 則 為 1
pane_at_left 如 果 窗 格 在 視 窗 的 左 側 則 為 1
pane_at_right 如 果 窗 格 在 視 窗 的 右 側 則 為 1
pane_at_top 如 果 窗 格 在 視 窗 的 頂 部 則 為 1
pane_bg 窗 格 背 景 顏 色
pane_bottom 窗 格 底 部
pane_current_command 當 前 命 令 （ 如 果 可 用 ）
pane_current_path 當 前 路 徑 （ 如 果 可 用 ）
pane_dead 如 果 窗 格 死 了 則 為 1
pane_dead_signal 死 窗 格 中 程 序 的 退 出 訊 號
pane_dead_status 死 窗 格 中 程 序 的 退 出 狀 態
pane_dead_time 死 窗 格 中 程 序 的 退 出 時 間
pane_fg 窗 格 前 景 色
pane_format 如 果 格 式 用 於 窗 格 則 為 1
pane_height 窗 格 高 度
pane_id #D 唯 一 窗 格 代 號
pane_in_mode 如 果 窗 格 處 於 某 種 模 式 則 為 1
pane_index #P 窗 格 索 引
pane_input_off 如 果 禁 用 窗 格 輸 入 則 為 1
pane_last 如 果 最 後 一 個 窗 格 則 為 1
pane_left 窗 格 左 側
pane_marked 如 果 這 是 標 記 的 窗 格 則 為 1
pane_marked_set 如 果 設 定 了 標 記 的 窗 格 則 為 1
pane_mode 窗 格 模 式 的 名 稱 （ 如 果 有 ）
pane_path 窗 格 的 路 徑 （ 可 以 由 應 用 程 式 設 定 ）
pane_pid 窗 格 中 第 一 個 程 序 的 代 號
pane_pipe 如 果 窗 格 正 在 被 管 道 傳 輸 則 為 1
pane_right 窗 格 右 側
pane_search_string 複 製 模 式 下 的 最 後 搜 尋 字 串
pane_start_command 窗 格 開 始 命 令
pane_start_path 窗 格 開 始 路 徑
pane_synchronized 如 果 窗 格 同 步 則 為 1
pane_tabs 窗 格 選 項 卡 位 置
pane_title #T 窗 格 的 標 題 （ 可 以 由 應 用 程 式 設 定 ）
pane_top 窗 格 頂 部
pane_tty 窗 格 的 偽 終 端
pane_width 窗 格 的 寬 度
pid 伺 服 器 程 序 代 號
rectangle_toggle 如 果 矩 形 選 擇 被 啟 用 則 為 1
scroll_position 複 製 模 式 下 的 滾 動 位 置
scroll_region_lower 窗 格 中 滾 動 區 域 的 底 部
scroll_region_upper 窗 格 中 滾 動 區 域 的 頂 部
search_match 搜 尋 匹 配 項 （ 如 果 有 ）
search_present 如 果 搜 尋 以 複 製 模 式 開 始 則 為 1
selection_active 如 果 選 擇 以 複 製 模 式 開 始 並 隨 游 標 變 化 則 為 1
selection_end_x 選 擇 結 束 的 X 位 置
selection_end_y 選 擇 結 束 的 Y 位 置
selection_present 如 果 選 擇 以 複 製 模 式 開 始 則 為 1
selection_start_x 選 擇 開 始 的 X 位 置
selection_start_y 選 擇 開 始 的 Y 位 置
session_activity 上 次 活 動 的 會 話 時 間
session_alerts 帶 有 警 報 的 視 窗 索 引 列 表
session_attached 會 話 附 加 到 客 戶 端 數 量
session_attached_list 會 話 被 附 加 到 的 客 戶 端 列 表
session_created 建 立 的 時 間 會 話
session_format 如 果 格 式 用 於 會 話 則 為 1
session_group 會 話 組 名 稱
session_group_attached 組 中 的 會 話 被 附 加 到 的 客 戶 端 數 量
session_group_attached_list 組 中 的 會 話 被 附 加 到 的 客 戶 端 列 表
session_group_list 組 中 會 話 列 表
session_group_many_attached 如 果 多 個 客 戶 端 附 加 到 組 中 的 會 話 則 為 1
session_group_size 會 話 組 的 大 小
session_grouped 如 果 會 話 在 一 個 組 中 則 為 1
session_id 唯 一 會 話 代 號
session_last_attached 上 次 連 線 的 時 間 會 話
session_many_attached 如 果 連 線 了 多 個 客 戶 端 則 為 1
session_marked 如 果 此 會 話 包 含 標 記 的 窗 格 則 為 1
session_name #S 會 話 名 稱
session_path 會 話 的 工 作 目 錄
session_stack 按 最 近 順 序 排 列 的 視 窗 索 引
session_windows 會 話 中 的 視 窗 數
socket_path 伺 服 器 套 接 字 路 徑
start_time 伺 服 器 啟 動 時 間
uid 伺 服 器 使 用 者 代 號
user 伺 服 器 使 用 者
version 伺 服 器 版 本
window_active 如 果 視 窗 活 躍 則 為 1
window_active_clients 檢 視 此 視 窗 的 客 戶 數 量
window_active_clients_list 檢 視 此 視 窗 的 客 戶 列 表
window_active_sessions 此 視 窗 處 於 活 動 狀 態 的 會 話 數
window_active_sessions_list 此 視 窗 處 於 活 動 狀 態 的 會 話 列 表
window_activity 視 窗 上 次 活 動 的 時 間
window_activity_flag 如 果 視 窗 有 活 動 則 為 1
window_bell_flag 如 果 視 窗 有 響 鈴 則 為 1
window_bigger 如 果 視 窗 大 於 客 戶 端 則 為 1
window_cell_height 每 個 單 元 格 的 高 度 （ 以 畫 素 為 單 位 ）
window_cell_width 每 個 單 元 格 的 寬 度 （ 以 畫 素 為 單 位 ）
window_end_flag 如 果 視 窗 具 有 最 高 索 引 則 為 1
window_flags #F 帶 有 # 轉 義 為 ## 的 視 窗 標 誌
window_format 如 果 格 式 用 於 一 個 視 窗 則 為 1
window_height 視 窗 高 度
window_id 唯 一 視 窗 標 識
window_index #I 視 窗 索 引
window_last_flag 如 果 視 窗 是 最 後 使 用 的 則 為 1
window_layout 窗 口 布 局 描 述 ， 忽 略 縮 放 的 視 窗 窗 格
window_linked 如 果 視 窗 跨 會 話 連 結 則 為 1
window_linked_sessions 此 視 窗 連 結 到 的 會 話 數
window_linked_sessions_list 此 視 窗 連 結 到 的 會 話 列 表
window_marked_flag 如 果 視 窗 包 含 標 記 的 窗 格 則 為 1
window_name #W 視 窗 名 稱
window_offset_x 如 果 大 於 客 戶 端 ， 則 偏 移 X 到 視 窗
window_offset_y 如 果 大 於 客 戶 ， 則 偏 移 Y 到 視 窗 中
window_panes 視 窗 中 的 窗 格 數
window_raw_flags 沒 有 逃 脫 的 視 窗 標 誌
window_silence_flag 如 果 視 窗 有 靜 音 警 報 為 1
window_stack_index 會 話 在 最 新 堆 疊 中 的 索 引
window_start_flag 如 果 視 窗 具 有 最 低 索 引 為 1
window_visible_layout 窗 口 布 局 描 述 ， 尊 重 縮 放 的 視 窗 窗 格
window_width 視 窗 寬 度
window_zoomed_flag 如 果 視 窗 被 縮 放 為 1
wrap_flag 窗 格 換 行 標 誌

樣 式

tmux 提 供 了 各 種 選 項 ， 以 指 定 介 面 各 個 方 面 的 顏 色 和 屬 性 ， 例 如 狀 態 行 的 status-style 。 此 外 ， 可 以 透 過 將 嵌 入 式 樣 式 包 含 在 格 式 選 項 中 （ 如 status-left ） ， 使 用 ’#[’ 和 ’]’ 括 起 來 來 指 定 嵌 入 式 樣 式 。

一 個 樣 式 可 以 是 單 個 術 語 ’default’ ， 用 於 指 定 預 設 樣 式 （ 可 能 來 自 選 項 ， 例 如 狀 態 行 中 的 status-style ） ， 或 由 以 下 內 容 組 成 的 空 格 或 逗 號 分 隔 的 列 表 ：

fg=colour

設 定 前 景 顏 色 。 顏 色 可 以 是 以 下 之 一 ： black 、 red 、 green 、 yellow 、 blue 、 magenta 、 cyan 、 white ； 如 果 支 持 ， 則 是 明 亮 的 變 體 ， 例 如 brightred 、 brightgreen 、 brightyellow ； 從 256 色 彩 集 中 的 colour0 到 colour255 ； default 表 示 預 設 顏 色 ， terminal 表 示 終 端 的 預 設 顏 色 ； 或 者 是 十 六 進 位 制 RGB 字 串 ， 例 如 ’#ffffff’ 。

bg=colour

設 定 背 景 顏 色 。

none

不 設 定 任 何 屬 性 （ 關 閉 任 何 活 動 屬 性 ） 。

acs, bright （ 或 bold ） 、 dim 、 underscore 、 blink 、 reverse 、 hidden 、 italics 、 overline 、 strikethrough 、 double-underscore 、 curly-underscore 、 dotted-underscore 、 dashed-underscore

設 定 一 個 屬 性 。 任 何 屬 性 都 可 以 以 ’no’ 作 為 字 首 來 取 消 設 定 。 acs 是 終 端 的 備 用 字 符 集 。

align=left （ 或 noalign ） 、 align=centre 、 align=right

根 據 需 要 將 文 字 左 對 齊 、 居 中 或 右 對 齊 到 可 用 的 空 間 。

fill=colour

如 果 合 適 ， 用 背 景 顏 色 填 充 可 用 空 間 。

list=on, list=focus 、 list=left-marker 、 list=right-marker 、 nolist

標 記 各 個 視 窗 列 表 元 件 在 status-format 選 項 中 的 位 置 ： list=on 標 記 列 表 的 開 始 ； list=focus 是 應 該 保 持 焦 點 的 列 表 部 分 ， 如 果 整 個 列 表 無 法 適 應 可 用 空 間 （ 通 常 是 當 前 視 窗 ） ； list=left-marker 和 list=right-marker 標 記 要 用 於 標 記 從 列 表 左 側 或 右 側 裁 剪 文 字 的 文 字 ， 如 果 沒 有 足 夠 的 空 間 。

push-default, pop-default

將 當 前 的 顏 色 和 屬 性 儲 存 為 預 設 值 ， 或 者 恢 復 到 以 前 的 默 認 值 。 push-default 影 響 任 何 後 續 使 用 default 術 語 的 操 作 ， 直 到 出 現 pop-default 。 只 能 推 送 一 個 預 設 值 （ 每 個 push-default 替 換 以 前 儲 存 的 預 設 值 ） 。

range=left, range=right 、 range=window|X 、 norange

標 記 status-format 選 項 中 的 範 圍 。 range=left 和 range=right 是 用 於 ’StatusLeft’ 和 ’StatusRight’ 滑 鼠 鍵 的 文 字 。 range=window|X 是 傳 遞 給 ’Status’ 滑 鼠 鍵 的 視 窗 範 圍 ， 其 中 ’X’ 是 一 個 視 窗 索 引 。

例 子 是 ：

fg=yellow bold underscore blink
bg=black,fg=default,noreverse

名 稱 和 標 題

tmux 區 分 名 稱 和 標 題 。 視 窗 和 會 話 都 有 名 稱 ， 可 以 在 目 標 中 使 用 它 們 ， 並 在 狀 態 行 和 各 種 列 表 中 顯 示 ： 名 稱 是 視 窗 或 會 話 的 tmux 識 別 符 號 。 只 有 窗 格 有 標 題 。 窗 格 的 標 題 通 常 由 執 行 在 窗 格 內 部 的 程 式 使 用 轉 義 序 列 進 行 設 定 （ 就 像 設 定 X(7) 中 的 xterm(1) 視 窗 標 題 一 樣 ） 。 視 窗 本 身 沒 有 標 題 ——視 窗 的 標 題 是 其 活 動 窗 格 的 標 題 。 tmux 本 身 可 以 設 定 客 戶 端 執 行 的 終 端 的 標 題 ， 請 參 見 set-titles 選 項 。

會 話 的 名 稱 使 用 new-session 和 rename-session 命 令 來 設 定 。 視 窗 的 名 稱 使 用 以 下 命 令 之 一 來 設 定 ：

1.

命 令 引 數 （ 例 如 -n 用 於 new-window 或 new-session ） 。

2.

轉 義 序 列 （ 如 果 已 啟 用 allow-rename 選 項 ） ：

$ printf ’\033kWINDOW_NAME\033\\’

3.

自 動 重 新 命 名 ， 將 名 稱 設 定 為 視 窗 活 動 窗 格 中 的 活 動 命 令 。 請 參 閱 automatic-rename 選 項 。

當 窗 格 首 次 建 立 時 ， 其 標 題 是 主 機 名 。 可 以 透 過 標 題 設 定 轉 義 序 列 來 設 定 窗 格 的 標 題 ， 例 如 ：

$ printf ’\033]2;My Title\033\\’

也 可 以 使 用 select-pane -T 命 令 進 行 修 改 。

全 域 性 和 會 話 環 境

當 伺 服 器 啟 動 時 ， tmux 將 環 境 複 製 到 global environment 中 ； 此 外 ， 每 個 會 話 都 有 自 己 的 session environment 。 建 立 視 窗 時 ， 會 合 並 會 話 和 全 域 性 環 境 。 如 果 變 數 在 兩 個 環 境 中 都 存 在 ， 則 使 用 會 話 環 境 中 的 值 。 結 果 是 傳 遞 給 新 程 序 的 初 始 環 境 。

當 建 立 新 會 話 或 重 新 附 加 舊 會 話 時 ， 可 以 使 用 update-environment 會 話 選 項 從 客 戶 端 更 新 會 話 環 境 。 tmux 還 使 用 一 些 內 部 資 訊 初 始 化 TMUX 變 數 ， 以 允 許 從 內 部 執 行 命 令 ， 並 使 用 正 確 的 ’screen’ 終 端 設 定 初 始 化 TERM 變 數 。

會 話 和 全 域 性 環 境 中 的 變 數 都 可 以 標 記 為 隱 藏 。 隱 藏 變 數 不 會 傳 遞 到 新 程 序 的 環 境 中 ， 而 是 隻 能 被 tmux 自 身 使 用 （ 例 如 在 格 式 中 ， 參 見 FORMATS 部 分 ） 。

改 變 和 檢 視 環 境 的 命 令 是 ：

set-environment [-Fhgru] [-t 目 標 會 話 ] 名 稱 [值 ]

(別 名 ： Ic setenv)

設 定 或 取 消 設 定 環 境 變 數 。 如 果 使 用 了 -g ， 則 更 改 將 在 全 域 性 環 境 中 進 行 ； 否 則 ， 它 將 應 用 於 target-session 的 會 話 環 境 。 如 果 存 在 -F ， 則 value 將 作 為 格 式 進 行 展 開 。 -u 標 誌 取 消 設 定 變 數 。 -r 表 示 在 啟 動 新 進 程 之 前 從 環 境 中 刪 除 變 數 。 -h 將 變 數 標 記 為 隱 藏 。

show-environment [-hgs] [-t 目 標 會 話 ] [變 數 ]

(別 名 ： Ic showenv)

顯 示 目 標 會 話 的 環 境 或 使 用 -g 顯 示 全 域 性 環 境 。 如 果 省 略 變 數 ， 則 顯 示 所 有 變 數 。 從 環 境 中 刪 除 的 變 數 字 首 為 ’-’ 。 如 果 使 用 了 -s ， 則 輸 出 格 式 化 為 一 組 Bourne shell 命 令 。 -h 顯 示 隱 藏 變 數 （ 預 設 情 況 下 省 略 ） 。

狀 態 行

tmux 包 括 一 個 可 選 的 狀 態 行 ， 它 顯 示 在 每 個 終 端 的 底 部 行 。

預 設 情 況 下 ， 狀 態 行 已 啟 用 ， 高 度 為 一 行 （ 可 以 使 用 status 會 話 選 項 禁 用 或 使 其 變 為 多 行 ） ， 從 左 到 右 包 含 ： 當 前 會 話 的 名 稱 （ 在 方 括 號 中 ） ； 視 窗 列 表 ； 活 動 窗 格 的 標 題 （ 在 雙 引 號 中 ） ； 以 及 時 間 和 日 期 。

狀 態 行 的 每 一 行 都 使 用 status-format 選 項 進 行 配 置 。 預 設 值 由 三 個 部 分 組 成 ： 可 配 置 的 左 側 和 右 側 部 分 （ 可 以 包 含 動 態 內 容 ， 如 時 間 或 來 自 shell 命 令 的 輸 出 ， 請 參 見 下 面 的 status-left 、 status-left-length 、 status-right 和 status-right-length 選 項 ） ， 以 及 中 央 的 視 窗 列 表 。 預 設 情 況 下 ， 視 窗 列 表 按 數 字 升 序 顯 示 當 前 會 話 中 存 在 的 視 窗 的 索 引 、 名 稱 和 （ 如 果 有 ） 標 誌 。 可 以 使 用 window-status-format 和 window-status-current-format 選 項 來 自 定 義 視 窗 列 表 。 標 誌 是 附 加 在 視 窗 名 稱 後 面 的 以 下 符 號 之 一 ：

符 號 含 義
* 表 示 當 前 視 窗 。
- 標 記 最 後 一 個 視 窗 （ 先 前 選 擇 的 ） 。
# 監 視 視 窗 活 動 並 檢 測 到 活 動 。
! 視 窗 響 鈴 受 到 監 控 ， 視 窗 內 出 現 鈴 響 。
~ 視 窗 在 監 視 器 靜 默 間 隔 內 一 直 保 持 靜 默 。
M 該 視 窗 包 含 標 記 的 窗 格 。
Z 視 窗 的 活 動 窗 格 被 縮 放 。

# 符 號 與 monitor-activity 視 窗 選 項 有 關 。 如 果 存 在 警 報 （ 鈴 聲 、 活 動 或 靜 默 ） ， 則 視 窗 名 稱 以 反 色 列 印 。

可 以 配 置 狀 態 行 的 顏 色 和 屬 性 ， 使 用 status-style 會 話 選 項 配 置 整 個 狀 態 行 ， 使 用 window-status-style 視 窗 選 項 配 置 各 個 視 窗 。

如 果 狀 態 行 發 生 了 更 改 ， 狀 態 行 會 自 動 在 一 定 時 間 間 隔 內 進 行 重 新 整 理 ， 可 以 使 用 status-interval 會 話 選 項 控 制 重 新 整 理 間 隔 。

與 狀 態 行 相 關 的 命 令 如 下 ：

clear-prompt-history [-T 提 示 型 別 ]

(別 名 ： Ic clearphist)

清 除 提 示 型 別 為 提 示 型 別 的 提 示 歷 史 記 錄 。 如 果 省 略 了 -T ， 則 清 除 所 有 型 別 的 歷 史 記 錄 。 有 關 提 示 型 別 可 能 的 值 ， 請 參 見 command-prompt 。

command-prompt [-1bFikN] [-I 輸 入 ] [-p 提 示 ] [-t 目 標 客 戶 端 ] [-T 提 示 型 別 ] [模 板 ]

在 客 戶 端 中 開 啟 命 令 提 示 符 。 這 可 以 從 tmux 內 部 用 於 互 動 式 執 行 命 令 。

如 果 指 定 了 template ， 則 它 將 用 作 命 令 。 如 果 使 用 了 -F ， 則 template 將 作 為 格 式 展 開 。

如 果 存 在 ， -I 是 每 個 提 示 的 初 始 文 字 的 逗 號 分 隔 列 表 。 如 果 給 出 了 -p ， 則 prompts 是 按 順 序 顯 示 的 逗 號 分 隔 的 提 示 列 表 ； 否 則 ， 將 顯 示 單 個 提 示 ， 如 果 存 在 template ， 則 構 造 自 它 ， 否 則 為 ’:’ 。

在 執 行 命 令 之 前 ， 字 串 ’%%’ 的 第 一 次 出 現 和 所 有 ’%1’ 的 出 現 都 將 替 換 為 第 一 個 提 示 的 響 應 ， 所 有 ’%2’ 都 將 替 換 為 第 二 個 提 示 的 響 應 ， 以 此 類 推 進 行 更 多 提 示 。 最 多 可 以 替 換 九 個 提 示 響 應 ， 從 ’%1’ 到 ’%9’ 。 ’%%%’ 類 似 於 ’%%’ ， 但 任 何 引 號 都 會 被 轉 義 。

-1 使 提 示 僅 接 受 一 個 按 鍵 ， 此 時 輸 入 結 果 為 單 個 字 元 。 -k 類 似 於 -1 ， 但 按 鍵 被 轉 換 為 鍵 名 。 -N 使 提 示 僅 接 受 數 字 按 鍵 。 -i 在 每 次 提 示 輸 入 更 改 時 執 行 命 令 ， 而 不 是 在 使 用 者 退 出 命 令 提 示 符 時 執 行 。

-T tells tmux the prompt type. This affects what completions are offered when Tab is pressed. Available types are: ’command’, ’search’, ’target’ and ’window-target’.

-T 告 訴 tmux 提 示 型 別 。 這 會 影 響 按 下 Tab 時 提 供 的 自 動 補 全 。 可 用 的 型 別 包 括 ： ’command’ 、 ’search’ 、 ’target’ 和 ’window-target’ 。

功 能 vi emacs
取 消 命 令 提 示 q Escape
從 游 標 處 刪 除 到 單 詞 開 頭 C-w
刪 除 整 個 命 令 d C-u
從 游 標 處 刪 除 到 結 尾 D C-k
執 行 命 令 Enter Enter
從 歷 史 中 獲 取 下 一 個 命 令 Down
從 歷 史 中 獲 取 上 一 個 命 令 Up
插 入 頂 部 貼 上 緩 衝 區 p C-y
尋 找 補 全 Tab Tab
向 左 移 動 游 標 h Left
向 右 移 動 游 標 l Right
移 動 游 標 到 結 尾 $ C-e
將 游 標 移 動 到 下 一 個 單 詞 w M-f
將 游 標 移 動 到 上 一 個 單 詞 b M-b
移 動 游 標 到 開 始 0 C-a
轉 置 字 元 C-t

使 用 -b ， 提 示 顯 示 在 後 臺 ， 並 且 呼 叫 客 戶 端 在 其 被 解 除 之 前 不 會 退 出 。

confirm-before [-by] [-c 確 認 鍵 ] [-p 提 示 ] [-t 目 標 客 戶 端 ] 命 令

(別 名 ： Ic confirm)

在 執 行 命 令 之 前 詢 問 確 認 。 如 果 給 出 了 -p ， 則 提 示 是 要 顯 示 的 提 示 ； 否 則 ， 將 從 命 令 構 造 提 示 。 它 可 以 包 含 status-left 選 項 支 持 的 特 殊 字 元 序 列 。 使 用 -b ， 提 示 顯 示 在 後 臺 ， 並 且 呼 叫 客 戶 端 在 其 被 解 除 之 前 不 會 退 出 。

display-menu [-O] [-c 目 標 客 戶 端 ] [-t 目 標 窗 格 ] [-S 起 始 選 擇 ] [-T 標 題 ] [-x 位 置 ] [-y 位 置 ] 名 稱 快 捷 鍵 命 令 [引 數 ...]

(別 名 ： Ic menu)

在 目 標 客 戶 端 上 顯 示 選 單 。 目 標 窗 格 為 從 選 單 執 行 的 任 何 命 令 指 定 目 標 。

選 單 作 為 一 系 列 引 數 傳 遞 ： 首 先 是 選 單 項 名 稱 ， 其 次 是 快 捷 鍵 （ 如 果 沒 有 則 為 空 ） ， 第 三 個 是 在 選 擇 選 單 項 時 要 執 行 的 命 令 。 名 稱 和 命 令 都 是 格 式 ， 請 參 見 格 式 和 樣 式 部 分 。 如 果 名 稱 以 連 字 元 （ -） 開 頭 ， 則 禁 用 該 專 案 （ 顯 示 為 灰 暗 ） ， 不 能 選 擇 。 名 稱 可 以 為 空 以 用 作 分 隔 線 ， 在 這 種 情 況 下 ， 鍵 和 命 令 都 應 省 略 。

-T 是 選 單 標 題 的 格 式 （ 請 參 閱 格 式 ） 。

-x 和 -y 給 出 選 單 的 位 置 。 “都 行 ”可 以 是 行 號 或 列 號 ， 或 以 下 特 殊 值 之 一 ：

值 符 號 含 義
C 都 行 終 端 中 心
R -x 終 端 右 側
P 都 行 窗 格 左 下 角
M 都 行 滑 鼠 位 置
W 都 行 狀 態 行 上 的 視 窗 位 置
S -y 狀 態 行 上 方 或 下 方 的 行

或 擴 充 套 件 的 格 式 ， 包 括 以 下 附 加 變 數 ：

變 數 名 替 換 為
popup_centre_x 以 客 戶 端 為 中 心
popup_centre_y 以 客 戶 端 為 中 心
popup_height 選 單 或 彈 出 視 窗 的 高 度
popup_mouse_bottom 滑 鼠 底 部
popup_mouse_centre_x 滑 鼠 水 平 中 心
popup_mouse_centre_y 滑 鼠 垂 直 中 心
popup_mouse_top 滑 鼠 頂 部
popup_mouse_x 滑 鼠 X 位 置
popup_mouse_y 滑 鼠 Y 位 置
popup_pane_bottom 窗 格 底 部
popup_pane_left 窗 格 左 邊
popup_pane_right 窗 格 右 邊
popup_pane_top 窗 格 頂 部
popup_status_line_y 高 於 或 低 於 狀 態 行
popup_width 選 單 或 彈 出 視 窗 的 寬 度
popup_window_status_line_x 在 狀 態 行 的 視 窗 位 置
popup_window_status_line_y 在 顯 示 視 窗 的 狀 態 行

每 個 選 單 都 由 專 案 和 括 號 中 顯 示 的 鍵 快 捷 方 式 組 成 。 如 果 選 單 太 大 而 無 法 適 合 終 端 ， 則 不 會 顯 示 。 按 下 鍵 快 捷 方 式 選 擇 相 應 的 專 案 。 如 果 啟 用 了 滑 鼠 ， 並 且 從 滑 鼠 鍵 繫 結 開 啟 了 選 單 ， 則 選 擇 一 個 專 案 後 釋 放 滑 鼠 按 鈕 選 擇 該 專 案 ， 而 不 選 擇 專 案 釋 放 滑 鼠 按 鈕 將 關 閉 選 單 。 -O 更 改 此 行 為 ， 使 得 當 釋 放 滑 鼠 按 鈕 而 沒 有 選 擇 專 案 時 ， 選 單 不 關 閉 ， 必 須 單 擊 滑 鼠 按 鈕 才 能 選 擇 專 案 。

以 下 鍵 也 可 用 ：

快 捷 鍵 功 能
Enter 選 擇 所 選 專 案
Up 選 擇 上 一 項
Down 選 擇 下 一 項
q 退 出 選 單

display-message [-aIlNpv] [-c 目 標 客 戶 端 ] [-d 延 遲 ] [-t 目 標 窗 格 ] [訊 息 ]

(別 名 ： Ic display)

顯 示 一 條 訊 息 。 如 果 給 出 了 -p ， 則 輸 出 將 列 印 到 標 準 輸 出 中 ， 否 則 將 在 目 標 客 戶 端 狀 態 行 中 顯 示 ， 最 多 延 遲 延 遲 毫 秒 。 如 果 未 給 出 延 遲 ， 則 使 用 顯 示 時 間 選 項 ； 延 遲 為 零 等 待 按 鍵 。 ’N’ 忽 略 按 鍵 並 僅 在 延 遲 到 期 後 關 閉 。 訊 息 的 格 式 在 格 式 部 分 中 描 述 ； 如 果 給 出 了 -t ， 則 從 目 標 窗 格 中 獲 取 資 訊 ， 否 則 從 活 動 面 板 中 獲 取 。

-v 在 解 析 格 式 時 列 印 詳 細 日 誌 ， -a 列 出 格 式 變 數 及 其 值 。

-I 將 從 標 準 輸 入 讀 取 的 任 何 輸 入 轉 發 到 由 target-pane 指 定 的 空 面 板 。

display-popup [-BCE] [-b 邊 界 線 ] [-c 目 標 客 戶 端 ] [-d 起 始 目 錄 ] [-e 環 境 ] [-h 高 度 ] [-s 樣 式 ] [-S 邊 框 樣 式 ] [-t 目 標 窗 格 ] [-T 標 題 ] [-w 寬 度 ] [-x 位 置 ] [-y 位 置 ] [外 殼 命 令 ]

(別 名 ： Ic popup)

在 目 標 客 戶 端 上 顯 示 執 行 外 殼 命 令 的 彈 出 視 窗 。 彈 出 視 窗 是 繪 製 在 任 何 面 板 上 方 的 矩 形 框 。 當 彈 出 窗 口 出 現 時 ， 面 板 不 會 更 新 。

-E 在 外 殼 命 令 退 出 時 自 動 關 閉 彈 出 視 窗 。 兩 個 -E 僅 在 外 殼 命 令 成 功 退 出 時 關 閉 彈 出 視 窗 。

-x 和 -y 給 出 彈 出 視 窗 的 位 置 ， 它 們 的 含 義 與 display-menu 命 令 相 同 。 -w 和 -h 給 出 寬 度 和 高 度 - 兩 者 都 可 以 是 百 分 比 （ 後 跟 ’%’) 。 如 果 省 略 ， 則 使 用 終 端 大 小 的 一 半 。

-B 不 會 用 邊 框 包 圍 彈 出 視 窗 。

-b 設 定 彈 出 視 窗 的 邊 框 線 型 別 。 當 指 定 了 -B 時 ， -b 選 項 將 被 忽 略 。 有 關 邊 界 線 的 可 能 值 ， 請 參 見 popup-border-lines 。

-s 設 定 彈 出 視 窗 的 樣 式 ， -s 設 定 彈 出 視 窗 邊 框 的 樣 式 。 有 關 如 何 指 定 樣 式 ， 請 參 閱 樣 式 章 節 。

-e 的 格 式 為 ’變 數 =值 ’ ， 它 為 彈 出 視 窗 設 定 一 個 環 境 變 數 ； 可 以 多 次 指 定 。

-T 是 彈 出 標 題 的 格 式 （ 請 參 閱 格 式 ） 。

-c 標 誌 關 閉 客 戶 端 上 的 任 何 彈 出 視 窗 。

show-prompt-history [-T 提 示 型 別 ]

(別 名 ： Ic showphist)

顯 示 提 示 型 別 提 示 型 別 的 狀 態 提 示 符 歷 史 記 錄 。 如 果 省 略 了 -T ， 則 顯 示 所 有 型 別 的 歷 史 記 錄 。 有 關 提 示 型 別 的 可 能 值 ， 請 參 見 command-prompt 。

緩 衝 區

tmux 維 護 一 組 命 名 的 貼 上 緩 衝 區 。 每 個 緩 衝 區 可 以 是 顯 式 或 自 動 命 名 的 。 當 使 用 set-buffer 或 load-buffer 命 令 建 立 緩 衝 區 時 ， 或 使 用 set-buffer -n 將 自 動 命 名 緩 衝 區 重 新 命 名 時 ， 顯 式 命 名 緩 衝 區 被 命 名 。 自 動 命 名 緩 衝 區 被 賦 予 類 似 ’buffer0001’ 、 ’buffer0002’ 等 名 稱 。 當 達 到 buffer-limit 選 項 時 ， 最 舊 的 自 動 命 名 緩 衝 區 將 被 刪 除 。 顯 式 命 名 緩 衝 區 不 受 buffer-limit 的 限 制 ， 可 以 使 用 delete-buffer 命 令 刪 除 。

可 以 使 用 copy-mode 或 set-buffer 和 load-buffer 命 令 新 增 緩 衝 區 ， 並 使 用 paste-buffer 命 令 將 其 貼 上 到 視 窗 中 。 如 果 使 用 緩 衝 區 命 令 但 沒 有 指 定 緩 衝 區 ， 則 假 定 最 近 新 增 的 自 動 命 名 緩 衝 區 。

每 個 視 窗 還 維 護 一 個 可 配 置 的 歷 史 記 錄 緩 衝 區 。 預 設 情 況 下 ， 保 留 多 達 2000 行 ； 可 以 使 用 history-limit 選 項 （ 參 見 上 面 的 set-option 命 令 ） 進 行 更 改 。

緩 衝 區 命 令 如 下 ：

將 窗 格 置 於 緩 衝 區 模 式 ， 可 以 從 列 表 中 互 動 地 選 擇 緩 衝 區 。 每 個 緩 衝 區 顯 示 在 一 行 上 ， 左 側 用 括 號 顯 示 快 捷 鍵 ， 可 立 即 選 擇 ， 或 使 用 下 面 的 按 鍵 瀏 覽 列 表 並 選 擇 或 以 其 他 方 式 操 作 專 案 。 -Z 可 以 縮 放 窗 格 。 在 緩 衝 區 模 式 下 ， 可 以 使 用 以 下 按 鍵 ： choose-buffer [-NZr] [-F format] [-f filter] [-K key-format] [-O sort-order] [-t target-pane] [template]

快 捷 鍵 功 能
Enter 貼 上 選 定 的 緩 衝 區
Up 選 擇 上 一 個 緩 衝 區
Down 選 擇 下 一 個 緩 衝 區
C-s 按 名 稱 或 內 容 搜 尋
n 重 複 上 次 搜 尋
t 如 果 緩 衝 區 被 標 記 則 切 換
T 標 記 無 緩 衝 區
C-t 標 記 所 有 緩 衝 區
p 貼 上 選 定 的 緩 衝 區
P 貼 上 標 記 緩 衝 區
d 刪 除 選 定 的 緩 衝 區
D 刪 除 標 記 的 緩 衝 區
e 在 編 輯 器 中 開 啟 緩 衝 區
f 輸 入 過 濾 專 案 的 格 式
O 更 改 排 序 欄 位
r 反 向 排 序
v 切 換 預 覽
q 退 出 模 式

選 擇 緩 衝 區 後 ， 模 板 中 的 ’%%’ 將 被 緩 衝 區 名 稱 替 換 ， 並 將 結 果 作 為 命 令 執 行 。 如 果 未 指 定 模 板 ， 則 使 用 “paste-buffer -b ’%%’”。

-O 指 定 初 始 排 序 欄 位 ： 可 以 是 ’time’ 、 ’name’ 或 ’size’ 中 的 一 個 。 -r 反 轉 排 序 順 序 。 -f 指 定 初 始 篩 選 器 ： 篩 選 器 是 一 個 格 式 - 如 果 它 的 結 果 為 零 ， 則 列 表 中 的 專 案 不 顯 示 ， 否 則 顯 示 。 如 果 篩 選 器 會 導 致 空 列 表 ， 則 忽 略 它 。 -F 指 定 列 表 中 每 個 專 案 的 格 式 ， -K 指 定 每 個 快 捷 鍵 的 格 式 ； 兩 者 都 對 每 行 進 行 一 次 求 值 。 -N 在 不 顯 示 預 覽 的 情 況 下 啟 動 。 此 命 令 僅 在 至 少 有 一 個 客 戶 端 連 線 時 才 有 效 。

clock-mode [-t 目 標 窗 格 ]

(別 名 ： Ic clearhist)

刪 除 並 釋 放 指 定 窗 格 的 歷 史 記 錄 。 -H 還 會 刪 除 所 有 超 連 結 。

delete-buffer [-b 緩 衝 區 名 稱 ]

(別 名 ： Ic deleteb)

刪 除 名 為 緩 衝 區 名 稱 的 緩 衝 區 ， 如 果 未 指 定 ， 則 刪 除 最 近 新 增 的 自 動 命 名 的 緩 衝 區 。

list-buffers [-F 格 式 ] [-f 過 濾 器 ]

(別 名 ： Ic lsb)

列 出 全 域 性 緩 衝 區 。 -F 指 定 每 行 的 格 式 ， -f 指 定 一 個 篩 選 器 。 只 顯 示 篩 選 器 為 真 的 緩 衝 區 。 請 參 見 格 式 部 分 。

load-buffer [-w] [-b 緩 衝 區 名 稱 ] [-t 目 標 客 戶 端 ] 路 徑

(別 名 ： Ic loadb)

從 路 徑 中 載 入 指 定 貼 上 緩 衝 區 的 內 容 。 如 果 給 出 了 -w ， 則 如 果 可 能 ， 使 用 xterm(1) 轉 義 序 列 將 緩 衝 區 傳 送 到 目 標 客 戶 端 的 剪 貼 簿 中 。

paste-buffer [-dpr] [-b 緩 衝 區 名 稱 ] [-s 分 隔 符 ] [-t 目 標 窗 格 ]

(別 名 ： Ic pasteb)

Insert the contents of a paste buffer into the specified pane. If not specified, paste into the current one. With -d, also delete the paste buffer. When output, any linefeed (LF) characters in the paste buffer are replaced with a separator, by default carriage return (CR). A custom separator may be specified using the -s flag. The -r flag means to do no replacement (equivalent to a separator of LF). If -p is specified, paste bracket control codes are inserted around the buffer if the application has requested bracketed paste mode.

save-buffer [-a] [-b 緩 衝 區 名 稱 ] 路 徑

(別 名 ： Ic saveb)

將 指 定 貼 上 緩 衝 區 的 內 容 儲 存 到 路 徑 。 -a 選 項 將 內 容 追 加 到 檔 案 而 不 是 覆 蓋 檔 案 。

set-buffer [-aw] [-b 緩 衝 區 名 稱 ] [-t 目 標 客 戶 端 ] [-n 新 緩 衝 區 名 稱 ] 資 料

(別 名 ： Ic setb)

將 指 定 緩 衝 區 的 內 容 設 定 為 資 料 。 如 果 給 出 了 -w ， 則 如 果 可 能 ， 使 用 xterm(1) 轉 義 序 列 將 緩 衝 區 傳 送 到 目 標 客 戶 端 的 剪 貼 簿 中 。 -a 選 項 將 內 容 追 加 到 緩 衝 區 而 不 是 覆 蓋 緩 衝 區 。 -n 選 項 將 緩 衝 區 重 新 命 名 為 新 緩 衝 區 名 稱 。

show-buffer [-b 緩 衝 區 名 稱 ]

(別 名 ： Ic showb)

顯 示 指 定 緩 衝 區 的 內 容 。

雜 項

雜 項 命 令 如 下 ：

clock-mode [-t 目 標 窗 格 ]

顯 示 一 個 大 時 鐘 。

if-shell [-bF] [-t 目 標 窗 格 ] 外 殼 命 令 命 令 [命 令 ]

(別 名 ： Ic if)

如 果 外 殼 命 令 （ 使 用 /bin/sh 執 行 ） 返 回 成 功 ， 則 執 行 第 一 個 命 令 ， 否 則 執 行 第 二 個 命 令 。 在 執 行 之 前 ， 外 殼 命 令 將 使 用 格 式 部 分 中 指 定 的 規 則 進 行 擴 充 套 件 ， 包 括 與 目 標 窗 格 相 關 的 規 則 。 使 用 -b 選 項 可 以 在 後 臺 執 行 外 殼 命 令 。

如 果 給 出 了 -F ， 則 不 執 行 外 殼 命 令 命 令 ， 但 在 擴 充 套 件 格 式 後 ， 如 果 不 為 空 且 不 為 零 ， 則 認 為 命 令 成 功 。

lock-server

(別 名 ： Ic lock)

透 過 執 行 由 lock-command 選 項 指 定 的 命 令 單 獨 鎖 定 每 個 客 戶 端 。

run-shell [-bC] [-d 延 遲 ] [-t 目 標 窗 格 ] [外 殼 命 令 ]

(別 名 ： run)

使 用 /bin/sh 或 （ 使 用 -C ） 在 後 臺 執 行 外 殼 命 令 命 令 ， 而 不 建 立 視 窗 。 在 執 行 之 前 ， 外 殼 命 令 將 使 用 格 式 部 分 中 指 定 的 規 則 進 行 擴 充 套 件 。 使 用 -b 選 項 可 以 在 後 臺 執 行 命 令 。 使 用 -d 選 項 可 以 在 啟 動 命 令 之 前 等 待 延 遲 秒 。 如 果 未 使 用 -C 選 項 ， 則 stdout 的 任 何 輸 出 都 將 在 命 令 完 成 後 以 檢 視 模 式 顯 示 （ 在 由 -t 指 定 的 窗 格 中 ， 如 果 省 略 則 為 當 前 窗 格 ） 。 如 果 命 令 失 敗 ， 則 還 會 顯 示 退 出 狀 態 。

wait-for [-L | -S | -U] 通 道

(別 名 ： wait)

如 果 沒 有 選 項 使 用 ， 則 防 止 客 戶 端 退 出 ， 直 到 使 用 相 同 通 道 的 wait-for -S 命 令 喚 醒 它 。 如 果 使 用 了 -L ， 則 鎖 定 該 通 道 ， 任 何 嘗 試 鎖 定 相 同 通 道 的 客 戶 端 都 必 須 等 待 ， 直 到 使 用 wait-for -U 命 令 解 鎖 通 道 。

退 出 訊 息

當 tmux 客 戶 端 分 離 時 ， 它 會 列 印 一 條 訊 息 。 這 可 能 是 以 下 之 一 ：

分 離 （ 從 會 話 ...）

客 戶 端 正 常 分 離 。

分 離 和 SIGHUP

客 戶 端 被 分 離 並 且 其 父 程 序 傳 送 了 SIGHUP 訊 號 （ 例 如 使 用 detach-client -P 命 令 ） 。

丟 失 tty

客 戶 端 的 tty(4) 或 pty(4) 被 意 外 銷 燬 。

終 止

客 戶 端 被 使 用 SIGTERM 訊 號 殺 死 。

太 落 後 了

客 戶 端 處 於 控 制 模 式 並 且 無 法 跟 上 來 自 tmux 的 資 料 。

退 出

伺 服 器 在 沒 有 會 話 時 退 出 。

伺 服 器 退 出

當 伺 服 器 接 收 到 SIGTERM 訊 號 時 退 出 。

伺 服 器 意 外 退 出

伺 服 器 崩 潰 或 以 其 他 方 式 退 出 而 沒 有 告 訴 客 戶 端 原 因 。

終 端 資 訊 擴 充 套 件

tmux 理 解 一 些 非 官 方 的 terminfo(5) 擴 充 套 件 。 通 常 不 需 要 手 動 設 定 這 些 擴 充 套 件 ， 而 應 該 使 用 terminal-features 選 項 。

AX

告 訴 tmux 終 端 支 援 預 設 顏 色 的 現 有 擴 充 套 件 。

Bidi

告 訴 tmux 終 端 支 援 vte 雙 向 文 字 擴 充 套 件 。

Cs, Cr

設 定 游 標 顏 色 。 第 一 個 命 令 帶 有 一 個 字 串 引 數 ， 用 於 設 定 顏 色 ； 第 二 個 命 令 不 帶 參 數 ， 用 於 恢 復 預 設 游 標 顏 色 。 如 果 設 定 了 顏 色 ， 可 以 使 用 類 似 下 面 的 序 列 在 tmux 中 更 改 游 標 顏 色 ：

$ printf ’\033]12;red\033\\’

顏 色 是 X(7) 顏 色 ， 請 參 見 XParseColor(3) 。

Cmg, Clmg, Dsmg, Enmg

設 定 、 清 除 、 禁 用 或 啟 用 DECSLRM 邊 距 。 如 果 終 端 報 告 自 己 相 容 VT420 ， 則 會 自 動 設 定 這 些 選 項 。

Dsbp, Enbp

禁 用 和 啟 用 括 號 貼 上 。 如 果 存 在 XT 能 力 ， 則 會 自 動 設 定 這 些 選 項 。

Dseks, Eneks

禁 用 和 啟 用 擴 充 套 件 鍵 。

Dsfcs, Enfcs

禁 用 和 啟 用 焦 點 報 告 。 如 果 存 在 XT 能 力 ， 則 會 自 動 設 定 這 些 選 項 。

Rect

告 訴 tmux 終 端 支 援 矩 形 操 作 。

Smol

啟 用 上 劃 線 屬 性 。

Smulx

設 定 帶 樣 式 的 下 劃 線 。 單 個 引 數 可 以 是 以 下 之 一 ： 0 表 示 沒 有 下 劃 線 ， 1 表 示 普 通 下 劃 線 ， 2 表 示 雙 下 劃 線 ， 3 表 示 捲 曲 下 劃 線 ， 4 表 示 點 下 劃 線 和 5 表 示 虛 線 下 劃 線 。

Setulc, ol

設 定 下 劃 線 顏 色 或 重 置 為 預 設 值 。 引 數 是 (紅 色 * 65536) + (綠 色 * 256) + 藍 色 ， 其 中 每 個 值 在 0 到 255 之 間 。

Ss, Se

設 定 或 重 置 游 標 樣 式 。 如 果 設 定 了 ， 可 以 使 用 此 類 序 列 將 游 標 更 改 為 下 劃 線 ：

$ printf ’\033[4 q’

如 果 未 設 定 Se ， 則 使 用 帶 有 引 數 0 的 Ss 重 置 游 標 樣 式 。

Swd

設 定 工 作 目 錄 通 知 的 開 頭 序 列 。 使 用 標 準 的 fsl 能 力 終 止 序 列 。

Sync

開 始 （ 引 數 為 1） 或 結 束 （ 引 數 為 2） 同 步 更 新 。

Tc

指 示 終 端 支 援 ’direct colour’ RGB 轉 義 序 列 （ 例 如 ， \e[38;2;255;255;255m） 。

如 果 支 援 ， 則 用 於 初 始 化 顏 色 轉 義 序 列 （ 可 以 透 過 將 ’initc’ 和 ’ccc’ 能 力 新 增 到 tmux terminfo(5) 條 目 中 啟 用 ） 。

這 相 當 於 RGB terminfo(5) 能 力 。

Ms

將 當 前 緩 衝 區 儲 存 在 主 機 終 端 的 選 擇 （ 剪 貼 簿 ） 中 。 請 參 見 上 面 的 set-clipboard 選 項 和 xterm(1) 手 冊 頁 。

XT

這 是 一 個 現 有 的 擴 充 套 件 能 力 ， tmux 使 用 它 來 表 示 終 端 支 援 xterm(1) 標 題 設 定 序 列 ， 並 自 動 設 定 上 述 某 些 能 力 。

控 制 方 式

tmux 提 供 了 一 個 名 為 control mode 的 文 字 介 面 。 這 允 許 應 用 程 式 使 用 簡 單 的 純 文 字 協 議 與 tmux 通 訊 。

在 控 制 模 式 下 ， 客 戶 端 在 標 準 輸 入 上 傳 送 以 換 行 符 結 尾 的 tmux 命 令 或 命 令 序 列 。 每 個 命 令 將 在 標 準 輸 出 上 產 生 一 個 輸 出 塊 。 輸 出 塊 由 %begin 行 開 始 ， 後 跟 輸 出 （ 可 能 為 空 ） 。 輸 出 塊 以 %end 或 %error 結 束 。 %begin 和 匹 配 的 %end 或 %error 具 有 三 個 引 數 ： 一 個 整 數 時 間 （ 從 紀 元 以 秒 為 單 位 ） ， 命 令 編 號 和 標 誌 （ 當 前 未 使 用 ） 。 例 如 ：

%begin 1363006971 2 1
0: ksh* (1 panes) [80x24] [layout b25f,80x24,0,0,2] @2 (active)
%end 1363006971 2 1

refresh-client -c 命 令 可 用 於 在 控 制 模 式 下 設 定 客 戶 端 的 大 小 。

在 控 制 模 式 下 ， tmux 輸 出 通 知 。 通 知 永 遠 不 會 出 現 在 輸 出 塊 內 。

定 義 了 以 下 通 知 ：

%client-detached 客 戶 端

客 戶 端 已 經 分 離 。

%client-session-changed 客 戶 端 會 話 代 號 名 稱

客 戶 端 現 在 已 連 線 到 代 號 為 會 話 代 號 的 會 話 ， 該 會 話 的 名 稱 為 名 稱 。

%continue 窗 格 代 號

在 暫 停 後 繼 續 了 該 窗 格 (如 果 設 定 了 之 後 暫 停 標 誌 ， 請 參 見 refresh-client -A) 。

%exit [原 因 ]

tmux 客 戶 端 立 即 退 出 ， 可 能 是 因 為 它 未 連 線 到 任 何 會 話 或 發 生 了 錯 誤 。 如 果 存 在 ， 原 因 描 述 客 戶 端 退 出 的 原 因 。

%extended-output 窗 格 代 號 年 齡 ... : 值

當 設 定 了 之 後 暫 停 標 誌 時 ， %output 的 新 形 式 被 髮 送 。 年 齡 是 tmux 在 傳 送 輸 出 之 前 緩 衝 輸 出 的 時 間 （ 以 毫 秒 為 單 位 ） 。 在 單 個 ’:’ 之 前 的 任 何 後 續 引 數 都 是 未 來 使 用 的 ， 應 該 被 忽 略 。

%layout-change 視 窗 代 號 窗 口 布 局 視 窗 可 見 佈 局 視 窗 標 誌

具 有 代 號 視 窗 代 號 的 視 窗 的 佈 局 已 更 改 。 新 佈 局 為 窗 口 布 局 。 視 窗 的 可 見 佈 局 為 視 窗 可 見 佈 局 ， 視 窗 標 誌 為 視 窗 標 誌 。

%output 窗 格 代 號 值

一 個 窗 格 產 生 輸 出 。 值 將 不 可 列 印 字 元 和 反 斜 槓 轉 義 為 八 進 位 制 \xxx。

%pane-mode-changed 窗 格 代 號

代 號 為 窗 格 代 號 的 窗 格 已 更 改 模 式 。

%pause 窗 格 代 號

窗 格 已 暫 停 （ 如 果 設 定 了 pause-after 標 誌 ） 。

%session-changed 會 話 代 號 姓 名

客 戶 端 現 在 已 連 線 到 代 號 為 會 話 代 號 的 會 話 ， 該 會 話 的 名 稱 為 名 稱 。

%session-renamed 姓 名

當 前 會 話 已 重 新 命 名 為 名 稱 。

%session-window-changed 會 話 代 號 視 窗 代 號

代 號 為 會 話 代 號 的 會 話 將 其 活 動 視 窗 更 改 為 代 號 為 視 窗 代 號 的 窗 口 。

%sessions-changed

建 立 或 銷 燬 了 一 個 會 話 。

%subscription-changed 名 稱 會 話 代 號 視 窗 代 號 視 窗 索 引 窗 格 代 號 ... : 值

與 訂 閱 名 稱 相 關 聯 的 格 式 的 值 已 更 改 為 value 。 請 參 見 refresh-client -B 。 在 pane-id 後 的 任 何 引 數 都 是 未 來 使 用 的 ， 應 該 被 忽 略 。

%unlinked-window-add 視 窗 代 號

代 號 為 視 窗 代 號 的 視 窗 已 建 立 ， 但 未 連 結 到 當 前 會 話 。

%unlinked-window-close 視 窗 代 號

未 連 結 到 當 前 會 話 的 代 號 為 視 窗 代 號 的 視 窗 已 關 閉 。

%unlinked-window-renamed 視 窗 代 號

未 連 結 到 當 前 會 話 的 代 號 為 視 窗 代 號 的 視 窗 已 被 重 新 命 名 。

%window-add 視 窗 代 號

代 號 為 視 窗 代 號 的 視 窗 連 結 到 當 前 會 話 。

%window-close 視 窗 代 號

代 號 為 視 窗 代 號 的 視 窗 關 閉 。

%window-pane-changed 視 窗 代 號 窗 格 代 號

視 窗 中 代 號 為 視 窗 代 號 的 活 動 窗 格 更 改 為 代 號 為 窗 格 代 號 的 窗 格 。

%window-renamed 視 窗 代 號 名 稱

代 號 為 視 窗 代 號 的 視 窗 被 重 新 命 名 為 名 稱 。

環 境

當 tmux 啟 動 時 ， 它 會 檢 查 以 下 環 境 變 數 ：

EDITOR

如 果 此 變 數 指 定 的 命 令 包 含 字 串 ’vi’ ， 且 VISUAL 未 設 定 ， 則 使 用 vi 風 格 的 鍵 繫 結 。 mode-keys 和 status-keys 選 項 會 覆 蓋 此 設 定 。

HOME

使 用 者 的 登 入 目 錄 。 如 果 未 設 定 ， 則 查 詢 passwd(5) 資 料 庫 。

LC_CTYPE

字 元 編 碼 locale(1) 。 它 用 於 兩 個 不 同 的 目 的 。 為 了 輸 出 到 終 端 ， 如 果 給 定 了 -u 選 項 或 LC_CTYPE 包 含 "UTF-8" 或 "UTF8" ， 則 使 用 UTF-8。 否 則 ， 只 寫 入 ASCII 字 元 ， 並 用 下 劃 線 (’_’) 替 換 非 ASCII 字 元 。 對 於 輸 入 ， tmux 總 是 在 UTF-8 語 言 環 境 下 執 行 。 如 果 作 業 系 統 提 供 了 en_US.UTF-8， 那 麼 就 使 用 它 ， LC_CTYPE 對 於 輸 入 會 被 忽 略 。 否 則 ， LC_CTYPE 告 訴 tmux 當 前 系 統 中 UTF-8 語 言 環 境 的 名 稱 。 如 果 由 LC_CTYPE 指 定 的 語 言 環 境 不 可 用 或 不 是 UTF-8 語 言 環 境 ， tmux 將 會 退 出 並 顯 示 錯 誤 資 訊 。

LC_TIME

日 期 和 時 間 格 式 locale(1) 。 它 用 於 依 賴 於 語 言 環 境 的 strftime(3) 格 式 說 明 符 。

PWD

當 前 工 作 目 錄 ， 將 在 全 域 性 環 境 中 進 行 設 定 。 如 果 它 包 含 符 號 連 結 ， 則 可 能 會 很 有 用 。 如 果 該 變 數 的 值 與 當 前 工 作 目 錄 不 匹 配 ， 則 會 忽 略 該 變 數 ， 並 使 用 getcwd(3) 的 結 果 。

SHELL

新 視 窗 預 設 使 用 的 shell 的 絕 對 路 徑 。 詳 細 資 訊 請 參 見 default-shell 選 項 。

TMUX_TMPDIR

包 含 伺 服 器 套 接 字 目 錄 的 父 目 錄 。 詳 細 資 訊 請 參 見 -L 選 項 。

VISUAL

如 果 此 變 數 指 定 的 命 令 包 含 字 串 ’vi’ ， 則 使 用 vi 風 格 的 鍵 繫 結 。 mode-keys 和 status-keys 選 項 會 覆 蓋 此 設 定 。

檔 案
~/.tmux.conf
$XDG_CONFIG_HOME/tmux/tmux.conf
~/.config/tmux/tmux.conf

預 設 tmux 配 置 檔 案 。

@SYSCONFDIR@/tmux.conf

系 統 範 圍 的 配 置 檔 案 。

示 例

要 建 立 一 個 執 行 vi(1) 的 新 tmux 會 話 ， 請 執 行 以 下 操 作 ：

$ tmux new-session vi

大 多 數 命 令 都 有 一 個 較 短 的 形 式 ， 稱 為 別 名 。 對 於 新 會 話 ， 這 是 new ：

$ tmux new vi

或 者 ， 接 受 命 令 的 最 短 明 確 形 式 。 如 果 有 多 個 選 項 ， 則 會 列 出 ：

$ tmux n
不 明 確 的 命 令 ： n ， 可 以 是 ： new-session, new-window, next-window

在 活 動 會 話 中 ， 可 以 透 過 鍵 入 ’C-b c’ (先 按 下 Ctrl 鍵 ， 然 後 是 ’b’ 鍵 ， 最 後 是 ’c’ 鍵 ) 來 建 立 一 個 新 視 窗 。

可 以 使 用 以 下 快 捷 鍵 導 航 視 窗 ： ’C-b 0’ （ 選 擇 視 窗 0） 、 ’C-b 1’ （ 選 擇 窗 口 1） 等 ； ’C-b n’ 選 擇 下 一 個 視 窗 ； ’C-b p’ 選 擇 上 一 個 視 窗 。

會 話 可 以 使 用 ’C-b d’ （ 或 外 部 事 件 如 ssh(1) 斷 開 連 線 ） 分 離 並 重 新 附 加 ：

$ tmux attach-session

輸 入 ’C-b ?’ 列 出 當 前 視 窗 的 當 前 鍵 繫 結 ； 可 以 使 用 上 下 箭 頭 導 航 列 表 或 ’q’ 退 出 。

當 tmux 伺 服 器 啟 動 時 要 執 行 的 命 令 可 以 放 在 ~/.tmux.conf 配 置 檔 案 中 。 常 見 的 示 例 包 括 ：

更 改 預 設 字 首 鍵 ：

set-option -g prefix C-a
unbind-key C-b
bind-key C-a send-prefix

關 閉 狀 態 行 或 更 改 其 顏 色 ：

set-option -g status off
set-option -g status-style bg=blue

設 定 其 他 選 項 ， 如 預 設 命 令 或 在 30分 鐘 不 活 動 後 鎖 定 ：

set-option -g default-command "exec /bin/ksh"
set-option -g lock-after-time 1800

建 立 新 的 鍵 繫 結 ：

bind-key b set-option status
bind-key / command-prompt "split-window ’exec man %%’"
bind-key S command-prompt "new-window -n %1 ’ssh %1’"

參 見

pty(4)

作 者

Nicholas Marriott <nicholas.marriott@gmail.com>

翻 譯

<https://github.com/Freed-Wu/tmux-zh/issues>