Zellij
Zellij 可以把一个终端分成多个窗格,也可以在不同标签页之间切换。断开连接后,会话中的程序可以继续运行,适合在 SSH 中运行任务,或者把编辑器、日志和命令行放在同一个工作环境中。

会话、标签页与窗格
在 Tmux 中,层级是 Server → Session → Window → Pane。Zellij 的日常操作可以按 Session → Tab → Pane 来理解,对应关系如下:
| Tmux | Zellij | 作用 |
|---|---|---|
| Session(会话) | Session(会话) | 容纳一套工作环境,分离后仍可保持其中的程序运行 |
| Window(窗口) | Tab(标签页) | 同一个工作环境中的一张工作台,可以包含多个窗格 |
| Pane(窗格) | Pane(窗格) | 工作台里的一个区域,可以运行 Shell 或其他程序 |
| 理解 Zellij 的相似概念与 Tmux 的对应,就可以无痛从 Tmux 中切换过来。 |
Session 恢复
Tmux 中,如果关闭 Tmux Server 或者关闭系统,曾经的 Tumx Session 会全部消失。而 Zellij 中,除非你显式关闭某个 Session,不然会话是不会自动关闭的。这表现为重启系统后之前的 Session 还存在于列表中。
不过会话中运行的进程与任务等确实已经结束,此时恢复会话是重新建立布局并重新启动命令。具体见后面的 恢复已退出的会话。
安装与配置
下面的路径和命令以 Linux 为例。直接去 官方 Releases 下载对应系统和架构的预编译二进制文件,解压后手动安装即可,不需要安装 Rust 和 Cargo 并本机编译,不然会耗费大量时间并引入大量垃圾。
先查看当前环境的架构:
uname -m输出为 x86_64 时,下载 zellij-x86_64-unknown-linux-musl.tar.gz。输出为 aarch64 时,下载 zellij-aarch64-unknown-linux-musl.tar.gz。
以 x86_64 为例,进入下载目录后执行:
# 解压二进制文件
tar -xzf zellij-x86_64-unknown-linux-musl.tar.gz
# 安装到系统命令目录,并设置执行权限
sudo install -m 755 zellij /usr/local/bin/zellij
# 确认安装路径和版本
command -v zellij
zellij --versionARM64 环境把解压命令中的文件名换成对应的 aarch64 包名,后面的步骤相同。/usr/local/bin 需要在 PATH 中,才能直接输入 zellij 启动。官方的二进制安装说明见 安装文档。
更新时,同样去发布页下载新版本,解压后替换 /usr/local/bin/zellij。如果旧版本仍在运行,可以先把新文件安装到旁边,再用重命名替换,避免直接覆盖正在使用的可执行文件:
# 在新版本的解压目录中执行
sudo install -m 755 zellij /usr/local/bin/zellij.new
sudo mv -f /usr/local/bin/zellij.new /usr/local/bin/zellij
command -v zellij
zellij --version更新程序与更新会话
替换文件不会让已有的后台会话自动变成新版本。当前版本支持在通信协议兼容时跨版本连接已有会话,具体限制见 官方 FAQ。如果要让会话也使用新版本,应当先保存工作、结束其中的任务,再关闭旧会话并重新创建。
Zellij 使用 KDL 格式的配置文件,通常位于 ~/.config/zellij/config.kdl。第一次启动时可能已经生成了这个文件,编辑之前先备份已有配置:
快捷键与其他配置
由于我不喜欢 Zellij 默认的冗杂快捷键与会和其他程序冲突的模式切换键,加上我们是从 Tmux 快速切换过来的,因此在 Zellij 中全盘使用 Tmux 的快捷键。
下文使用的是我配置的
Ctrl+b前缀键,不是 Zellij 默认快捷键。
我的配置默认进入 locked 模式,平时按键交给当前窗格中的程序处理。按 Ctrl+b 后进入 normal 模式,接收下一步操作。大部分操作完成后又回到 locked,用起来接近 Tmux 的前缀键。
clear-defaults=true 会清除默认快捷键,因此没有写在配置中的默认绑定不能直接使用。具体规则见 按键绑定说明。
将下面的配置保存为 ~/.config/zellij/config.kdl。这里保留了我的快捷键、会话管理器别名和关闭启动提示的设置,省去了原配置中没有启用的示例注释,以及与这些操作无关的插件和 Web 配置:
修改后可以检查配置,再启动一个会话:
zellij setup --check
zellij -s demoZellij 会监视当前配置文件,大部分配置修改后会立即生效,部分设置需要重启。具体以 配置说明 和配置项的注释为准。
会话管理
新建会话时可以指定一个方便记忆的名字,之后根据名字重新连接:
# 新建会话,名称由 Zellij 自动生成
zellij
# 新建名为 demo 的会话
zellij -s demo
# 查看会话列表
zellij list-sessions
zellij ls
# 连接名为 demo 的会话
zellij attach demo
zellij a demo
# 存在时连接,不存在时创建
zellij attach --create demo
# 关闭指定会话
zellij kill-session demo
# 关闭所有运行中的会话
zellij kill-all-sessions
# 关闭并彻底删除所有会话
zellij delete-all-sessions -f -y进入会话后,先按 Ctrl+b,松开,再按 d,就会分离当前会话并回到外层 Shell。分离不会关闭会话中的程序,下次运行 zellij a demo 就可以接着操作。
按 Ctrl+b 后再按 s 或 w,都会打开同一个会话管理器。可以根据界面提示选择会话、标签页和窗格,不必退出后再输入连接命令。
关闭会话中的所有标签也意味着关闭该会话。操作方式与 Tmux 类似。
快捷键操作
大部分操作会自动回到 locked 模式,连续操作时需要重新按前缀键。如果按了前缀但不想执行操作,可以按 Esc、Enter 或 Ctrl+c 返回。
快捷键均与 Tmux 一致,同时 Zellij 默认就开启了鼠标支持。
窗格控制
窗格用于在同一个标签页里同时显示多个终端:
# 以下操作先按 Ctrl+b
% # 在右侧新建窗格,左右分割
" # 在下方新建窗格,上下分割
h 或 ← # 切换到左侧窗格
j 或 ↓ # 切换到下方窗格
k 或 ↑ # 切换到上方窗格
l 或 → # 切换到右侧窗格
o # 切换到下一个窗格
z # 全屏显示当前窗格,再按一次组合键恢复
Space # 切换到下一个预设布局
Ctrl + 方向键 # 按指定方向调整当前窗格大小
x # 关闭当前窗格关闭前先检查任务
我的
x和&分别直接绑定CloseFocus和CloseTab,不像 Tmux 有额外配置确认步骤。关闭前先确认里面的任务已经结束或可以中断。
标签页控制
一个标签页放不下,或者想把不同用途的终端分开,可以新建标签页:
# 以下操作先按 Ctrl+b
c # 新建标签页
n # 切换到下一个标签页
p # 切换到上一个标签页
0 # 切换到第 1 个标签页
1 # 切换到第 2 个标签页
2~9 # 依次对应第 3~10 个标签页
, # 重命名当前标签页
& # 关闭当前标签页
s 或 w # 打开会话管理器重命名时直接输入新名称,按 Enter 确认,按 Esc 或 Ctrl+c 撤销本次修改。
数字键和标签页编号
Zellij 的
GoToTab参数从1开始,我把按键0绑定到GoToTab 1,按键1绑定到GoToTab 2,以此类推。
查看历史输出
先按 Ctrl+b,再按 [,进入滚动模式。进入后,下面的按键不需要再加前缀:
j 或 ↓ # 向下滚动一行
k 或 ↑ # 向上滚动一行
Ctrl+f 或 PageDown # 向下滚动一页
Ctrl+b 或 PageUp # 向上滚动一页
d 或 Ctrl+d # 向下滚动半页
u 或 Ctrl+u # 向上滚动半页
g # 滚动到顶部
G # 滚动到底部并退出滚动模式
/ # 输入搜索内容
n # 向下查找匹配项
N # 向上查找匹配项
e # 用编辑器打开当前窗格的历史输出
q、Enter、Esc 或 Ctrl+c # 回到底部并退出滚动模式搜索时先按 /,输入关键词后按 Enter,进入搜索模式,再用 n 或 N 查找。搜索模式下仍然可以使用上面的滚动按键。
复制文本
按默认行为,用鼠标拖动选中文本后,松开鼠标就会复制。
恢复已退出的会话
Zellij 默认会保存会话的布局和窗格中的命令信息。即使会话已经退出,也可能在会话列表中看到可以恢复的记录,可以通过会话管理器的 EXITED 页面选择,或者使用 zellij attach 会话名 恢复。
恢复时会重新建立标签页和窗格,记录下来的命令通常需要按 Enter 才会重新运行。
我的配置没有启用窗格画面和历史输出的序列化,因此不要依赖会话恢复来保存日志。详细机制见 会话恢复说明。
配置文件
// 清除 Zellij 内置的默认快捷键,仅使用下方定义的绑定。
keybinds clear-defaults=true {
// --------------------------------------------------------
// Normal 模式:快捷键操作模式
// --------------------------------------------------------
// 从 locked 模式按 Ctrl+b 进入。
// 多数操作结束后自动切回 locked,避免拦截终端输入。
normal {
// ===== Pane 焦点切换 =====
// 使用方向键或 Vim 风格的 hjkl 切换当前焦点。
bind "left" { MoveFocus "left"; SwitchToMode "locked"; }
bind "down" { MoveFocus "down"; SwitchToMode "locked"; }
bind "up" { MoveFocus "up"; SwitchToMode "locked"; }
bind "right" { MoveFocus "right"; SwitchToMode "locked"; }
bind "h" { MoveFocus "left"; SwitchToMode "locked"; }
bind "j" { MoveFocus "down"; SwitchToMode "locked"; }
bind "k" { MoveFocus "up"; SwitchToMode "locked"; }
bind "l" { MoveFocus "right"; SwitchToMode "locked"; }
// 按 Pane 的排列顺序切换焦点。
bind "o" { FocusNextPane; SwitchToMode "locked"; }
// ===== Pane 大小调整 =====
// Ctrl+方向键:向对应方向扩展当前 Pane。
bind "Ctrl left" { Resize "Increase left"; SwitchToMode "locked"; }
bind "Ctrl down" { Resize "Increase down"; SwitchToMode "locked"; }
bind "Ctrl up" { Resize "Increase up"; SwitchToMode "locked"; }
bind "Ctrl right" { Resize "Increase right"; SwitchToMode "locked"; }
// ===== Pane 创建与管理 =====
// ":在下方创建 Pane(上下分屏)。
// %:在右侧创建 Pane(左右分屏)。
bind "\"" { NewPane "down"; SwitchToMode "locked"; }
bind "%" { NewPane "right"; SwitchToMode "locked"; }
// 关闭当前获得焦点的 Pane。
bind "x" { CloseFocus; SwitchToMode "locked"; }
// 当前 Pane 全屏显示 / 恢复原布局。
bind "z" { ToggleFocusFullscreen; SwitchToMode "locked"; }
// 切换至下一个可用的交换布局(Swap Layout)。
bind "space" { NextSwapLayout; SwitchToMode "locked"; }
// ===== Tab 创建与管理 =====
// 创建新的 Tab。
bind "c" { NewTab; SwitchToMode "locked"; }
// 关闭当前 Tab。
bind "&" { CloseTab; SwitchToMode "locked"; }
// 进入 Tab 重命名模式,并清空当前输入。
bind "," { SwitchToMode "renametab"; TabNameInput 0; }
// 直接跳转 Tab。
// 此处采用 0-based 快捷键:数字 0 对应第 1 个 Tab。
bind "0" { GoToTab 1; SwitchToMode "locked"; }
bind "1" { GoToTab 2; SwitchToMode "locked"; }
bind "2" { GoToTab 3; SwitchToMode "locked"; }
bind "3" { GoToTab 4; SwitchToMode "locked"; }
bind "4" { GoToTab 5; SwitchToMode "locked"; }
bind "5" { GoToTab 6; SwitchToMode "locked"; }
bind "6" { GoToTab 7; SwitchToMode "locked"; }
bind "7" { GoToTab 8; SwitchToMode "locked"; }
bind "8" { GoToTab 9; SwitchToMode "locked"; }
bind "9" { GoToTab 10; SwitchToMode "locked"; }
// 按顺序切换至相邻 Tab。
bind "n" { GoToNextTab; SwitchToMode "locked"; }
bind "p" { GoToPreviousTab; SwitchToMode "locked"; }
// ===== Session 管理 =====
// d:从当前 Session 分离(Detach)。
// 分离不会终止 Session,内部程序继续运行。
bind "d" { SwitchToMode "locked"; Detach; }
// s / w:启动或聚焦 Session Manager 插件。
// floating:以浮动 Pane 形式显示。
// move_to_focused_tab:将插件移动到当前 Tab。
bind "s" {
LaunchOrFocusPlugin "session-manager" {
floating true
move_to_focused_tab true
}
SwitchToMode "locked"
}
bind "w" {
LaunchOrFocusPlugin "session-manager" {
floating true
move_to_focused_tab true
}
SwitchToMode "locked"
}
// ===== 滚动模式 =====
// 进入 Scroll 模式,浏览终端历史输出。
bind "[" { SwitchToMode "scroll"; }
// ===== 模式控制 =====
// 在 normal 模式下再次按 Ctrl+b:
// 发送 ASCII 0x02(Ctrl+B)给当前终端程序。
// 适用于需要将 Ctrl+b 传递给内层程序的场景。
bind "Ctrl b" { Write 2; SwitchToMode "locked"; }
// 退出快捷键模式。
bind "Ctrl c" { SwitchToMode "locked"; }
bind "esc" { SwitchToMode "locked"; }
}
// --------------------------------------------------------
// Locked 模式:默认模式
// --------------------------------------------------------
// 除 Ctrl+b 外,不拦截普通键盘输入。
// Shell、Vim、OpenCode 等程序可以正常接收快捷键。
locked {
// Ctrl+b:进入 Normal 模式,作为快捷键前缀。
bind "Ctrl b" { SwitchToMode "normal"; }
}
// --------------------------------------------------------
// Normal / RenameTab 共享快捷键
// --------------------------------------------------------
shared_among "normal" "renametab" {
// Enter:完成重命名或退出 Normal,返回 Locked。
bind "enter" { SwitchToMode "locked"; }
}
// --------------------------------------------------------
// 滚动及搜索模式的公共退出操作
// --------------------------------------------------------
shared_among "scroll" "entersearch" "search" {
// 取消滚动/搜索,滚动到底部并返回 Locked。
bind "Ctrl c" { ScrollToBottom; SwitchToMode "locked"; }
bind "esc" { ScrollToBottom; SwitchToMode "locked"; }
}
// --------------------------------------------------------
// Scroll / Search 模式
// --------------------------------------------------------
// Scroll:浏览历史输出。
// Search:在历史输出中查找匹配内容。
shared_among "scroll" "search" {
// ===== 基础滚动 =====
bind "down" { ScrollDown; }
bind "up" { ScrollUp; }
bind "j" { ScrollDown; }
bind "k" { ScrollUp; }
// ===== 按页滚动 =====
bind "PageDown" { PageScrollDown; }
bind "PageUp" { PageScrollUp; }
bind "Ctrl f" { PageScrollDown; }
bind "Ctrl b" { PageScrollUp; }
// ===== 半页滚动 =====
bind "d" { HalfPageScrollDown; }
bind "Ctrl d" { HalfPageScrollDown; }
bind "u" { HalfPageScrollUp; }
bind "Ctrl u" { HalfPageScrollUp; }
// ===== 快速跳转 =====
// g:跳转到历史输出顶部。
// G:跳转到底部并退出滚动/搜索。
bind "g" { ScrollToTop; }
bind "G" { ScrollToBottom; SwitchToMode "locked"; }
// ===== 搜索 =====
// /:进入搜索输入模式,并清空搜索输入。
bind "/" { SwitchToMode "entersearch"; SearchInput 0; }
// n / N:向下 / 向上查找匹配项。
bind "n" { Search "down"; SwitchToMode "search"; }
bind "N" { Search "up"; SwitchToMode "search"; }
// ===== 编辑历史输出 =====
// 使用外部编辑器打开当前 Pane 的 Scrollback。
bind "e" { EditScrollback; SwitchToMode "locked"; }
// ===== 退出 =====
// q / Enter:回到底部并退出。
bind "q" { ScrollToBottom; SwitchToMode "locked"; }
bind "enter" { ScrollToBottom; SwitchToMode "locked"; }
}
// --------------------------------------------------------
// EnterSearch 模式:输入搜索关键词
// --------------------------------------------------------
entersearch {
// Enter:结束关键词输入,进入搜索结果浏览模式。
bind "enter" { SwitchToMode "search"; }
}
// --------------------------------------------------------
// RenameTab 模式:重命名当前 Tab
// --------------------------------------------------------
renametab {
// 取消重命名,撤销本次修改并返回 Locked。
// Enter 的确认操作定义在上方 shared_among 中。
bind "Ctrl c" { UndoRenameTab; SwitchToMode "locked"; }
bind "esc" { UndoRenameTab; SwitchToMode "locked"; }
}
}
// ============================================================
// 插件配置
// ============================================================
plugins {
// 注册内置 Session Manager 插件。
// 可通过 Normal 模式下的 s / w 打开。
session-manager location="zellij:session-manager"
}
// ============================================================
// 全局配置
// ============================================================
// 默认进入 Locked 模式,避免 Zellij 抢占终端快捷键。
// 需要执行 Zellij 操作时,通过 Ctrl+b 临时进入 Normal。
default_mode "locked"
// 关闭启动时的快捷键提示。
show_startup_tips false