zellij命令速查
安装与版本、会话管理、标签面板、键位模式、KDL 布局与配置、插件、action 自动化与报错排查等 136 条命令
共 136 条命令 · 10 类场景 · 点击右侧图标可复制
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
zellij --version | 查看版本,插件与配置语法随版本演进 | |
zellij --help | 查看全部子命令与参数 | |
brew install zellij | macOS 安装 | |
cargo install --locked zellij | Rust 工具链安装,版本最新 | |
dnf install zellij | RHEL/Fedora 系安装(源里有则直接装) | |
snap install zellij | snap 安装,注意与 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.kdl | KDL 格式,与 tmux.conf 语法完全不同 |
| 命令 / 片段 | 说明 | 复制 |
|---|---|---|
zellij | 直接启动一个临时会话,退出即销毁 | |
zellij -s work | 创建命名会话,可脱离后恢复 | |
zellij attach work | 接入已存在的会话(a 为简写) | |
zellij a work | attach 的简写,日常少敲几个字 | |
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).txtzellij 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 锁了,再按一次即可
相关工具
Linux命令速查
文件、文本、权限、进程、网络、磁盘、systemd与防火墙等 Linux 常用命令速查手册
Docker命令速查
镜像、容器、网络、数据卷、Compose、Swarm、清理与排障等 Docker 常用命令速查手册
Nginx命令速查
服务管理、配置指令、反向代理、HTTPS、限流缓存、日志排查等 Nginx 常用命令速查手册
K8S命令速查
集群上下文、Pod调试、工作负载、Service与Ingress、存储、权限、排障等 kubectl 常用命令速查手册
Windows CMD命令速查
文件目录、网络诊断、进程服务、系统信息、用户权限、注册表、批处理等 Windows CMD 常用命令速查手册
systemctl服务管理速查
服务启停、开机自启、unit文件编写、日志查看、定时器、依赖分析与排障等 systemctl 命令速查手册
关于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 与后端工程师面试复习。