Zellij default.kdl 模式驱动 高频工作流

不要把 Zellij 当成只会分屏的终端。它更像一个可恢复的工作台。

下面的速查表把默认快捷键放进日常开发、长期托管、排错回看和多人/多会话管理里。每张卡片都写清楚“什么时候用”和“按键顺序”。

Ctrl g 锁定/解锁快捷键层,避免远程程序或编辑器快捷键被 Zellij 抢走。
Ctrl p 进入窗格模式,负责分屏、聚焦、全屏、浮动和关闭。
Ctrl t 进入标签模式,用标签承载项目、环境或任务阶段。
Ctrl s 进入滚动模式,回看日志、搜索输出、编辑 scrollback。

没有匹配项。可以搜索动作名、场景词,或直接搜索快捷键,例如 Ctrl t、Alt n、tmux。

先理解模式

Zellij 默认快捷键的重点不是一个全能前缀键,而是进入不同“模式”。进入后,字母键会被解释为 Zellij 动作;回到 Normal 后,键盘继续交给你的 shell、vim、ssh 或 REPL。

Normal 默认状态。运行命令、编辑代码、操作 shell。
EnterEsc
Pane 分屏和聚焦。最常用的布局控制层。
Ctrl p
Tab 项目级隔离。每个标签可以是一套工作区。
Ctrl t
Scroll 查看历史输出。适合日志、构建错误和测试失败。
Ctrl s
Resize 调整窗格尺寸。适合临时放大日志或编辑区。
Ctrl n
Session 脱离、恢复、配置、插件和布局管理。
Ctrl o

日常使用执行

这些是一天里最常碰到的动作:跑命令、看输出、临时开辅助 shell、快速回到代码。重点是减少在终端窗口之间来回切换。

临时开一个执行区

高频

正在编辑或看日志时,需要顺手跑 git status、进入 REPL、查环境变量,不想打断当前窗格。

Alt n直接新建窗格
Ctrl p然后n从 Pane 模式新建

在工作区内移动焦点

导航

左边编辑、右边服务、下方日志时,用方向聚焦比切窗口更快。

Alt hAlt jAlt kAlt l
Ctrl p然后hjkl

临时专注一个窗格

阅读

测试输出太长、diff 太宽、REPL 信息太密时,把当前窗格全屏;完成后再按一次恢复布局。

Ctrl p然后f

给重要输出让空间

布局

构建日志或编辑器需要更多空间时,先整体缩放,再精细调整边界。

Alt =放大Alt -缩小
Ctrl n然后hjkl

收掉完成的任务

清理

一次性命令、临时 shell 或已经退出的服务占着布局时,关闭当前焦点窗格。

Ctrl p然后x

把键盘还给程序

避冲突

进入 vim、fzf、远端 tmux 或全屏 TUI 后,如果担心 Zellij 快捷键误触,锁定快捷键层。

Ctrl g锁定;再按Ctrl g解锁

托管程序的高频操作

把 Zellij 当作本地或远程的进程工作台:一个窗格跑服务,一个窗格跑测试,一个窗格看日志,一个标签放数据库或后台任务。

服务 + 日志 + 命令行三件套

开发服务
  1. Ctrl pr右侧开服务窗格,运行 npm run devcargo run 或 Web 服务。
  2. Ctrl pd下方开日志/测试窗格,持续跑 tail -fpytest -f 或 watcher。
  3. Alt h/l/j/k在编辑区、服务区、日志区之间移动焦点,不需要离开一个终端窗口。

让程序继续跑,自己先离开

长期任务

远程机器上跑训练、爬虫、构建或服务时,用 detach 离开 Zellij,会话和窗格里的程序仍由 Zellij 托管。

Ctrl o然后d

重新进入通常使用命令行的 zellij attach 或会话管理器,具体取决于你启动会话的方式。

按系统层次拆标签

项目组织

一个标签放 Web 服务,一个标签放数据库/队列,一个标签放部署或运维命令。这样重启某类程序时不会误关其他进程。

Ctrl t然后n新建标签
Ctrl t然后r命名标签
Ctrl t然后19

多窗格同时执行同一命令

批量操作

多个 ssh 窗格、多个服务目录或多版本环境需要执行同一条命令时,开启当前标签同步输入。用完立即关闭,避免误操作。

Ctrl t然后s
托管长期程序时,优先用 Ctrl o d 脱离会话;不要把 Ctrl q 当成离开,它是 Quit,会结束 Zellij。只关闭某个任务时才用 Ctrl p x

窗格编排

窗格是“同一任务内的并行视图”。常见组合是编辑器、shell、日志、数据库客户端、远程主机。

场景 快捷键 适合怎么用
向下分屏 Ctrl p d 下方放日志、测试、编译输出,主窗格继续编辑或操作 shell。
向右分屏 Ctrl p r 右侧放服务进程、数据库客户端或远程 ssh,左右对照信息。
堆叠窗格 Ctrl p s 终端空间有限时,把多个辅助任务收进 stacked pane,按需切换。
浮动窗格 Alt fCtrl p w 临时查文档、跑一次命令、打开配置,不破坏当前布局。
嵌入/浮动切换 Ctrl p e 某个浮动任务变成长期任务时,把它嵌入布局;反过来也可以临时浮起。
关闭当前窗格 Ctrl p x 结束临时命令窗口或不再需要的服务窗口。
窗格命名 Ctrl p c 给长期服务命名,例如 api、worker、db、logs,减少误关误切。
隐藏/显示边框 Ctrl p z 录屏或窄屏时隐藏 pane frame,换取更多内容空间。

标签与项目层次

标签更适合表示“任务边界”,不是单纯的窗口编号。把不同生命周期的事情拆开,长期托管时更稳。

新开任务工作区

隔离

从开发切到排障、部署或数据库维护时,新建标签,避免把临时命令混进主开发窗格。

Ctrl t然后n

快速回到固定区域

导航

把 1 号标签固定为代码,2 号为服务,3 号为数据库,肌肉记忆会比标题搜索快。

Ctrl t然后19
Ctrl t然后hl

把窗格提升成标签

重组

某个服务或排错窗格变得复杂时,把它拆成独立标签继续展开。

Ctrl t然后b
Ctrl t然后[]

回看、搜索与复制

输出历史是排错的关键。Scroll 模式让你离开实时输出,定位错误,再回到底部继续观察。

回看长日志

排错

服务刷屏后,需要找第一次失败的位置。

Ctrl s进入 Scroll
j/k逐行Ctrl f/b翻页d/u半页

搜索错误或关键字

定位

构建失败时直接搜 error、panic、failed、端口号或请求 ID。

Ctrl s然后s输入并Enter
n下一个p上一个c大小写w环绕o整词

把历史输出交给编辑器

深查

日志太长、需要多处跳转或复制整理时,打开 scrollback editor,比在终端里滚动更可靠。

Ctrl s然后e

回到实时输出

观察

排查完旧日志后,回到底部继续观察服务是否恢复。

Ctrl c在 Scroll/Search 中回到底部并退出

会话与插件管理

Session 模式管理的是整个工作台,而不是单个窗格。长期运行、恢复现场、配置快捷键都在这里发生。

场景 快捷键 说明
脱离当前会话 Ctrl o d 让窗格里的服务、训练、构建继续运行,当前终端退出 Zellij。
打开会话管理器 Ctrl o w 查看和切换已有会话,适合同时维护多个项目或远程任务。
打开配置界面 Ctrl o c 检查配置和默认行为,适合调整前先确认当前状态。
插件管理 Ctrl o p 管理 Zellij 插件,默认配置中会以浮动窗格打开。
布局管理 Ctrl o l 管理 layout;适合把常用服务组合沉淀成固定启动布局。
分享入口 Ctrl o s 打开 share 插件。是否能通过网页分享,还取决于配置中的 web server / sharing 设置。

tmux 兼容层

默认配置保留 Ctrl b 进入 Tmux 模式,适合从 tmux 迁移时先维持旧习惯。但长期使用建议逐步换成 Zellij 的模式入口。

tmux 式分屏

迁移
Ctrl b然后"向下
Ctrl b然后%向右

tmux 式标签切换

迁移
Ctrl b然后c新标签
Ctrl b然后pn前后切换
Ctrl b然后,重命名

常见 tmux 习惯

迁移
Ctrl b然后z全屏
Ctrl b然后ddetach
Ctrl b然后Space下一个布局