Zellij

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

会话、标签页与窗格

在 Tmux 中,层级是 Server → Session → Window → Pane。Zellij 的日常操作可以按 Session → Tab → Pane 来理解,对应关系如下:

TmuxZellij作用
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 --version

ARM64 环境把解压命令中的文件名换成对应的 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 demo

Zellij 会监视当前配置文件,大部分配置修改后会立即生效,部分设置需要重启。具体以 配置说明 和配置项的注释为准。


会话管理

新建会话时可以指定一个方便记忆的名字,之后根据名字重新连接:

# 新建会话,名称由 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