GeekIt

zellij命令速查

安装与版本、会话管理、标签面板、键位模式、KDL 布局与配置、插件、action 自动化与报错排查等 136 条命令

共 136 条命令 · 10 类场景 · 点击右侧图标可复制

命令 / 片段说明复制
zellij --version查看版本,插件与配置语法随版本演进
zellij --help查看全部子命令与参数
brew install zellijmacOS 安装
cargo install --locked zellijRust 工具链安装,版本最新
dnf install zellijRHEL/Fedora 系安装(源里有则直接装)
snap install zellijsnap 安装,注意与 tmux 的终端能力差异
zellij setup --check自检配置与主题,改完配置建议先跑它
zellij setup --dump-config导出默认配置,作为自定义 config.kdl 的基线
zellij setup --generate-completion bash生成 shell 补全脚本
zellij setup --generate-auto-start bash生成自动启动包装,避免嵌套问题
zellij setup --clean清理配置与缓存,排障时的最后手段
配置文件默认在 ~/.config/zellij/config.kdlKDL 格式,与 tmux.conf 语法完全不同
命令 / 片段说明复制
zellij直接启动一个临时会话,退出即销毁
zellij -s work创建命名会话,可脱离后恢复
zellij attach work接入已存在的会话(a 为简写)
zellij a workattach 的简写,日常少敲几个字
zellij attach -c work不存在则创建,脚本与别名首选
zellij ls列出所有会话与状态
zellij kill-session work结束指定会话,内部进程随之退出
zellij kill-all-sessions结束全部会话,慎用
zellij delete-session work删除残留会话记录(对应已退出的会话)
zellij attach --index 0按序号接入,不想记名字时用
Ctrl+o 然后 d脱离当前会话,进程继续运行
Ctrl+o 然后 w打开会话管理器,可切换、创建、关闭会话
zellij 采用客户端-服务器架构会话由后台 server 持有,这是能脱离与共享的原因
多客户端可同时接入同一会话天然支持结对排障,屏幕内容实时同步
命令 / 片段说明复制
Ctrl+t 然后 n新建标签页(Tab)
Ctrl+t 然后 x关闭当前标签
Ctrl+t 然后 r重命名标签,长任务按用途命名更清晰
Ctrl+t 然后 1-9按编号切换标签
Ctrl+t 然后 方向键左右切换标签
Ctrl+p 然后 n在右侧新建面板(分屏)
Ctrl+p 然后 d在下方新建面板
Ctrl+p 然后 r在右侧新建面板(另一种键位习惯)
Ctrl+p 然后 x关闭当前面板
Ctrl+p 然后 f当前面板全屏切换,看日志必备
Ctrl+p 然后 w切换浮动面板,浮层不占布局空间
Ctrl+p 然后 方向键在面板之间移动焦点
Ctrl+n 然后 h/j/k/l调整面板大小
Ctrl+n 然后 + 或 -按步长增减尺寸
Ctrl+h 然后 方向键移动面板位置
面板边框会显示编号与标题配合 Ctrl+p 后按编号可直接跳转(视配置)
命令 / 片段说明复制
Ctrl+p进入 Pane 模式,新建、关闭、切换面板
Ctrl+t进入 Tab 模式,新建、关闭、重命名标签
Ctrl+n进入 Resize 模式,调整面板尺寸
Ctrl+h进入 Move 模式,移动面板位置
Ctrl+s进入 Scroll/Search 模式,翻历史与搜索
Ctrl+o进入 Session 模式,脱离、会话管理
Ctrl+g锁定模式,快捷键全部交给程序(再按一次解锁)
Ctrl+q退出当前会话
Esc 或 Enter从模式中退出,回到普通输入
锁定模式退出再按一次 Ctrl+g,或按提示的解锁键
模式化键位的好处不与程序内快捷键抢键,vim 用户更友好
键位可在 config.kdl 中改在 keybinds 段里重绑定,团队可统一
命令 / 片段说明复制
Ctrl+s 然后 方向键进入滚动模式翻看历史输出
Ctrl+s 然后 s在滚动模式内搜索关键字
Ctrl+s 然后 /搜索输入(视版本键位)
Ctrl+s 然后 e把当前缓冲区交给编辑器查看
选区 + y滚动模式下复制选中内容
Ctrl+p 然后 ]粘贴(以实际配置为准)
copy_command "pbcopy"macOS 下让复制进入系统剪贴板
copy_command "xclip -selection clipboard"Linux 下的等价配置
scroll_buffer_size 10000加大回滚缓冲,长日志场景必调
copy_clipboard "system"指定剪贴板后端,配合 copy_command 使用
鼠标选中失效时按住 Shift 选择可绕过 zellij 走终端原生选择
命令 / 片段说明复制
zellij --layout default使用内置布局启动
zellij --layout compact精简界面,适合小屏
zellij --layout strider带文件浏览器的布局
zellij --layout ./monitor.kdl使用自定义布局文件
layout { pane }最小布局:一个面板
pane split_direction="vertical"声明分屏方向
pane size=30%指定面板占比,做固定监控窗格很实用
pane borderless=true去掉边框,状态栏类面板常用
pane cwd="/var/log"指定工作目录
pane command="tail"启动时直接执行命令
args "-f" "/var/log/app.log"给 command 传参数
pane focus=true指定启动后焦点所在面板
default_tab_template { ... }新标签的默认骨架,常用来固定 tab-bar
pane { plugin location="zellij:tab-bar" }内置标签栏插件,放在模板顶部
zellij --layout monitor.kdl -s mon布局与会话同时指定,一条命令起环境
布局里可嵌套 tab 与 pane 多层复杂工作台建议拆成多个布局文件维护
命令 / 片段说明复制
zellij setup --dump-config > ~/.config/zellij/config.kdl生成完整默认配置再按需修改
theme "catppuccin-mocha"指定主题,内置主题可 setup --check 查看
default_layout "compact"设置默认布局
pane_frames false关闭面板边框,界面更清爽
mouse_mode true开启鼠标支持
scroll_buffer_size 10000回滚行数
simplified_ui true简化界面元素,减少干扰
show_startup_tips false关闭启动提示
keybinds { ... }自定义键位绑定,按模式分组
keybinds clear-defaults=true { ... }清空默认键位后完全自定义
copy_command "xclip -selection clipboard"剪贴板命令
default_mode "normal"设置启动时的模式
KDL 语法严格括号与缩进写错会直接启动失败,改完先 --check
配置文件支持热更新部分版本会自动重载,未生效时可重启会话
命令 / 片段说明复制
pane { plugin location="zellij:status-bar" }内置状态栏插件
pane { plugin location="zellij:compact-bar" }紧凑型底部栏
pane { plugin location="zellij:strider" }文件浏览器插件,选文件很方便
Ctrl+p 然后 w浮动面板开关,临时看日志不打断布局
zellij action new-pane --floating命令方式创建浮动面板
zellij action launch-plugin location="zellij:strider"从命令行启动插件
Ctrl+o 然后 p打开插件管理器,查看已加载插件
插件是 WASM 编译产物第三方插件需与 zellij 版本匹配
插件加载失败先看版本0.3x 与 0.4x 的插件 API 有差异
浮动面板可拖动与缩放适合快速核对信息后立刻关闭
命令 / 片段说明复制
zellij run -- tail -f /var/log/app.log在新面板里执行命令
zellij run --floating -- htop以浮动面板运行,用完即关
zellij edit /etc/nginx/nginx.conf在 zellij 内置编辑器/外部编辑器中打开文件
zellij action new-tab --name logs新建并命名标签
zellij action new-pane --direction down向下分屏
zellij action close-pane关闭当前面板
zellij action move-focus left移动焦点到左侧面板
zellij action toggle-fullscreen切换全屏
zellij action toggle-floating-panes切换浮动面板显示
zellij action dump-screen /tmp/snapshot.txt导出当前面板内容,做巡检留证
zellij action write-chars "make build\n"向当前面板注入命令并回车
zellij action list-clients查看接入该会话的客户端,排查谁连着
zellij --session work action new-tab对指定会话执行动作,脚本必备
zellij attach -c work && zellij --session work action ...先确保会话存在,再注入动作
命令 / 片段说明复制
键位差异tmux 用 prefix 键,zellij 用 Ctrl+字母进入模式
配置差异tmux 是纯命令式 tmux.conf,zellij 是 KDL 结构化配置
多客户端共享zellij 原生支持多客户端同时接入,tmux 需 -x
插件生态zellij 走 WASM,tmux 走 shell 脚本与 TPM
成熟度tmux 更老更稳,screen 最基础;zellij 体验现代但版本迭代快
zellij: command not found未安装或不在 PATH
Session already exists同名会话已存在,改用 attach
No such session会话名写错或已结束,用 zellij ls 核对
config 解析失败KDL 语法错误,用 setup --check 定位行号
layout 文件找不到路径写错或未放在配置目录,改用绝对路径
快捷键没反应可能处于 locked 模式,再按 Ctrl+g 解锁
快捷键被终端占用换终端或改 config.kdl 的 keybinds
复制不进系统剪贴板配置 copy_command,并确认 xclip/pbcopy 已安装
鼠标无法点击mouse_mode 未开启
中文宽字符错位换等宽字体并确认 UTF-8 locale
残留会话清理kill-session 后若仍显示,用 delete-session 删除记录
插件加载报错插件版本与 zellij 不匹配,升级到配套版本

运维常用组合

登录即恢复会话ssh host -t "zellij attach -c work"
一键监控布局zellij --layout monitor.kdl -s mon → 布局内已含日志与 htop 面板
临时看日志Ctrl+p 然后 w 开浮动面板 → zellij run --floating -- tail -f app.log → 关闭不影响布局
脚本注入命令zellij attach -c work → zellij --session work action new-tab --name build → zellij --session work action write-chars "make build\n"
导出面板内容zellij action dump-screen /tmp/screen-$(date +%F).txt
排障顺序zellij ls → setup --check → 检查 config.kdl 语法 → 再怀疑插件与主题

实战要点

1. 先记四个模式键

Ctrl+p 面板、Ctrl+t 标签、Ctrl+o 会话、Ctrl+g 锁定,其余可现查

2. 用 attach -c

存在就接入、不存在就创建,别名里写死这一条最省心

3. 布局即工作台

把常用分屏写进 KDL 布局,一条命令起整套环境

4. 剪贴板要配 copy_command

不配就只能终端内复制,跨应用粘贴会失效

5. 改配置先 --check

KDL 语法严格,写错会直接启动失败

6. 锁定模式别慌

快捷键全失效多半是 Ctrl+g 锁了,再按一次即可

共 136 条 zellij 命令 · 快捷键以默认模式键为基准,自定义 keybinds 后请按实际配置操作

关于zellij命令速查

在线 zellij 命令与快捷键速查手册,按安装与版本、会话管理、标签与面板、键位模式、KDL 布局、config.kdl 配置、插件与浮动面板、脚本与 action 自动化、与 tmux 对比迁移、常见报错与排查等 10 类场景整理 130 余条常用命令、快捷键与配置片段,每条附中文说明与可直接复制的写法,支持关键词搜索、分类折叠和一键复制,打开网页即可查阅。涵盖 zellij --version 与 --help 与 setup --check 与 --dump-config 与 --generate-completion 与 --generate-auto-start 与 --clean 与 brew/cargo 安装、无参启动与 -s 命名会话 与 attach 与 attach -c 与 ls 与 kill-session 与 kill-all-sessions 与 delete-session 与 attach --index、--layout default/compact/strider 与 --layout 自定义 kdl 与 --session 与 run -- 命令 与 run --floating 与 edit、默认键位模式 Ctrl+p 面板 与 Ctrl+t 标签 与 Ctrl+n 调整大小 与 Ctrl+h 移动 与 Ctrl+s 滚动搜索 与 Ctrl+o 会话 与 Ctrl+g 锁定 与 Ctrl+q 退出,面板模式 n 新建 与 d 向下分屏 与 r 向右分屏 与 x 关闭 与 f 全屏 与 w 浮动 与方向键移动焦点,标签模式 n 新建 与 x 关闭 与 r 重命名 与数字切换,会话模式 d 脱离 与 w 会话管理器 与 p 插件管理器,滚动模式的 s 进入与复制粘贴,以及 layout 的 pane 与 size 与 borderless 与 split_direction 与 cwd 与 command 与 args 与 focus 与 default_tab_template 与 tab-bar/status-bar/compact-bar 插件行,config.kdl 的 keybinds 与 theme 与 default_layout 与 pane_frames 与 mouse_mode 与 copy_command 与 scroll_buffer_size 与 simplified_ui 与 show_startup_tips 与 copy_clipboard,脚本化的 zellij action new-pane/close-pane/new-tab/close-tab/rename-tab/move-focus/toggle-fullscreen/toggle-floating-panes/dump-screen/write-chars/list-clients/rename-session/launch-plugin 与 zellij --session x action 与 setup --generate-auto-start,还有 zellij 客户端服务器架构与多客户端共享会话、与 tmux 的键位与配置差异及迁移建议,以及 command not found、Session already exists、No such session、config 解析错误(KDL 语法)、layout 文件找不到、键位被终端占用、剪贴板不生效需 copy_command、鼠标模式未开、locked 模式如何退出、插件与版本不匹配、会话残留 等报错排查。适用于 Linux/macOS 终端多路复用与远程会话保持、多任务分屏与布局复用、团队统一 keybinds 与主题、脚本化创建面板并注入命令、从 tmux 迁移到 zellij,以及运维、SRE 与后端工程师面试复习。

核心能力

  • 涵盖 zellij --version 与 --help 与 setup --check 与 --dump-config 与 --generate-completion 与 --generate-auto-start 与 --clean 与 brew/cargo 安装、无参启动与 -s 命名会话 与 attach 与 attach -c 与 ls 与 kill-session 与 kill-all-sessions 与 delete-session 与 attach --index、--layout default/compact/strider 与 --layout 自定义 kdl 与 --session 与 run -- 命令 与 run --floating 与 edit、默认键位模式 Ctrl+p 面板 与 Ctrl+t 标签 与 Ctrl+n 调整大小 与 Ctrl+h 移动 与 Ctrl+s 滚动搜索 与 Ctrl+o 会话 与 Ctrl+g 锁定 与 Ctrl+q 退出,面板模式 n 新建 与 d 向下分屏 与 r 向右分屏 与 x 关闭 与 f 全屏 与 w 浮动 与方向键移动焦点,标签模式 n 新建 与 x 关闭 与 r 重命名 与数字切换,会话模式 d 脱离 与 w 会话管理器 与 p 插件管理器,滚动模式的 s 进入与复制粘贴,以及 layout 的 pane 与 size 与 borderless 与 split_direction 与 cwd 与 command 与 args 与 focus 与 default_tab_template 与 tab-bar/status-bar/compact-bar 插件行,config.kdl 的 keybinds 与 theme 与 default_layout 与 pane_frames 与 mouse_mode 与 copy_command 与 scroll_buffer_size 与 simplified_ui 与 show_startup_tips 与 copy_clipboard,脚本化的 zellij action new-pane/close-pane/new-tab/close-tab/rename-tab/move-focus/toggle-fullscreen/toggle-floating-panes/dump-screen/write-chars/list-clients/rename-session/launch-plugin 与 zellij --session x action 与 setup --generate-auto-start,还有 zellij 客户端服务器架构与多客户端共享会话、与 tmux 的键位与配置差异及迁移建议,以及 command not found、Session already exists、No such session、config 解析错误(KDL 语法)、layout 文件找不到、键位被终端占用、剪贴板不生效需 copy_command、鼠标模式未开、locked 模式如何退出、插件与版本不匹配、会话残留 等报错排查

适用场景

适用于 Linux/macOS 终端多路复用与远程会话保持、多任务分屏与布局复用、团队统一 keybinds 与主题、脚本化创建面板并注入命令、从 tmux 迁移到 zellij,以及运维、SRE 与后端工程师面试复习。zellij命令速查全程在浏览器中完成,无需安装插件,可放心用于日常办公与排障。

常见问题

zellij命令速查是免费的吗?需要注册或安装吗?
zellij命令速查完全免费,无需注册、无需下载安装任何软件,用浏览器打开网页即可直接使用,也不限制使用次数。
zellij命令速查支持哪些功能?
涵盖 zellij --version 与 --help 与 setup --check 与 --dump-config 与 --generate-completion 与 --generate-auto-start 与 --clean 与 brew/cargo 安装、无参启动与 -s 命名会话 与 attach 与 attach -c 与 ls 与 kill-session 与 kill-all-sessions 与 delete-session 与 attach --index、--layout default/compact/strider 与 --layout 自定义 kdl 与 --session 与 run -- 命令 与 run --floating 与 edit、默认键位模式 Ctrl+p 面板 与 Ctrl+t 标签 与 Ctrl+n 调整大小 与 Ctrl+h 移动 与 Ctrl+s 滚动搜索 与 Ctrl+o 会话 与 Ctrl+g 锁定 与 Ctrl+q 退出,面板模式 n 新建 与 d 向下分屏 与 r 向右分屏 与 x 关闭 与 f 全屏 与 w 浮动 与方向键移动焦点,标签模式 n 新建 与 x 关闭 与 r 重命名 与数字切换,会话模式 d 脱离 与 w 会话管理器 与 p 插件管理器,滚动模式的 s 进入与复制粘贴,以及 layout 的 pane 与 size 与 borderless 与 split_direction 与 cwd 与 command 与 args 与 focus 与 default_tab_template 与 tab-bar/status-bar/compact-bar 插件行,config.kdl 的 keybinds 与 theme 与 default_layout 与 pane_frames 与 mouse_mode 与 copy_command 与 scroll_buffer_size 与 simplified_ui 与 show_startup_tips 与 copy_clipboard,脚本化的 zellij action new-pane/close-pane/new-tab/close-tab/rename-tab/move-focus/toggle-fullscreen/toggle-floating-panes/dump-screen/write-chars/list-clients/rename-session/launch-plugin 与 zellij --session x action 与 setup --generate-auto-start,还有 zellij 客户端服务器架构与多客户端共享会话、与 tmux 的键位与配置差异及迁移建议,以及 command not found、Session already exists、No such session、config 解析错误(KDL 语法)、layout 文件找不到、键位被终端占用、剪贴板不生效需 copy_command、鼠标模式未开、locked 模式如何退出、插件与版本不匹配、会话残留 等报错排查。
zellij命令速查适合哪些场景使用?
适用于 Linux/macOS 终端多路复用与远程会话保持、多任务分屏与布局复用、团队统一 keybinds 与主题、脚本化创建面板并注入命令、从 tmux 迁移到 zellij,以及运维、SRE 与后端工程师面试复习。