# Zellij 指南 — 个人参考 > 二进制文件： `/Users/wcygan/.nix-profile/bin/zellij` （通过 Nix flake 安装）配置： `~/Development/dotfiles/config/zellij/config.kdl` → 符号链接到 `~/.config/zellij/config.kdl` 布局： `~/Development/dotfiles/config/zellij/layouts/` 有关详尽的操作/选项/布局参考，请参阅 [reference.md]()。 ** ** ## 快速入门 zellij # 新会话（随机名称） zellij -s work # 新命名会话 zellij -l dev # 具有 dev.kdl 布局的新会话 zellij ls # 列出会话（包括退出的） zellij a work # 附加到“work”会话 zellij d work # 删除退出的会话 ** ** ## 你的按键绑定（clear-defaults=true，vim 风格）您的配置使用“clear-defaults=true”——仅存在以下绑定： ### 正常模式（默认）关键|行动 ---|--- `Ctrl h` |向左移动焦点/选项卡 `Ctrl l` |向右移动焦点/选项卡 `Ctrl j` |将焦点向下移动 `Ctrl k` |向上移动焦点 `Ctrl n` |新窗格（自动方向） `Ctrl s` |新窗格向下 `Ctrl v` |新窗格右侧 `Ctrl-` |新窗格向下 `Ctrl /` |新窗格右侧 `Ctrl x` |关闭聚焦窗格 `Ctrl z` |切换全屏 `Ctrlt` |新标签页 `Ctrl w` |关闭选项卡 `Ctrl 1-5` |转到选项卡 1-5 `Ctrl q` |戒烟 `Ctrl d` |分离 `Ctrl p` | → 窗格模式 `Ctrl r` | → 调整大小模式 `Ctrl m` | → 移动模式 `Ctrl g` | → 锁定模式 `Ctrl b` | → 滚动模式 ### 窗格模式（`Ctrl p` 进入，`Esc` 退出）关键|行动 ---|--- `h/j/k/l` |移动焦点 `n` |新窗格 `x` |关闭窗格 `f` |切换全屏 `w` |切换浮动窗格 `e` |切换嵌入/浮动 `r` |重命名窗格 ### 调整大小模式（`Ctrl r` 进入，`Esc` 退出）关键|行动 ---|--- `h/j/k/l` |调整大小方向 `H/J/K/L` |增加方向 `=` |增加尺寸 `-` |减小尺寸 ### 移动模式（`Ctrl m` 进入，`Esc` 退出）关键|行动 ---|--- `h/j/k/l` |沿方向移动窗格 ### 滚动模式（`Ctrl b` 进入，`Esc` 退出）关键|行动 ---|--- `j/k` |向下/向上滚动 `Ctrl d` / `Ctrl u` |向下/向上半页 `g` |滚动到顶部 `G` |滚动到底部 ### 锁定模式（`Ctrl g` 进行切换）所有密钥都会传递到终端。只有`Ctrl g`退出。 ### 未配置模式（默认）您的配置未定义：`tab`、`search`、`entersearch`、`renametab`、`renamepane`、`session`、`tmux`。考虑添加“搜索”和“会话”模式以进行回滚搜索和会话管理器访问。 ** ** ## 您的配置摘要 // config.kdl 中的关键设置： default_layout "compact" // 1 行紧凑栏（选项卡 + 状态组合） pane_frames false // 窗格之间没有边框 theme "default" // Base16 深色主题（内联定义） default_shell“~/.nix-profile/bin/fish” 选择时复制 true 滚动回编辑器“/ usr / bin / nvim” session_serialization true // 启用复活 serialize_pane_viewport true // 保存可见内容最大窗格数 100 布局目录“~/.config/zellij/layouts” **注意**：`default_shell` 和 `layout_dir` 使用 `/home/wcygan/` 路径 (Linux)。在 macOS 上，这些路径应该是“/Users/wcygan/”路径。考虑使用 `$HOME` 或更新以供跨平台使用。 ** ** ## 你的布局 ### dev.kdl（3 选项卡开发布局）选项卡“主”（聚焦）： ┌──────────────────────┬──────────┐ │ │ 终端 │ │ 编辑 (70%) ├──────────┤ │ │ 日志 │ └──────────────────────┴──────────┘ 选项卡“git”：lazygit（全窗格）选项卡“监控”：btop (50%) + 服务 (50%) 加载： `zellij -l dev` 或 `zellij --layout ~/.config/zellij/layouts/dev.kdl` ** ** ## 模式参考（共 13 个）模式|目的|你的绑定 ---|---|--- `正常` |默认操作 | （默认） `锁定` |传递（安全）| `Ctrl g` `窗格` |窗格管理 | `Ctrl p` `调整大小` |调整窗格大小 | `Ctrl r` `移动` |移动窗格 | `Ctrl m` `滚动` |滚动缓冲区 | `Ctrl b` `选项卡` |标签管理| _（未绑定）_ `搜索` |向后滚动搜索 | _（未绑定）_ `进入搜索` |输入搜索查询 | _（未绑定）_ `重命名表` |重命名选项卡 | _（未绑定）_ `重命名窗格` |重命名窗格 | _（未绑定）_ `会话` |会话管理 | _（未绑定）_ `tmux` | tmux 兼容性 | _（未绑定）_ ** ** ## CLI 快速参考 ### 会话管理 zellij # 新会话 zellij -s # 命名会话 zellij ls # 列出所有（正在运行+已退出） zellij Attach # 附加/复活 zellij Attach -c <名称> # 创建或附加 zellij Kill-session # 终止正在运行的会话 zellij delete-session # 删除退出的会话 zellij Kill-all-sessions # 杀死所有会话 zellij delete-all-sessions # 删除所有已退出的会话 ### 在窗格中运行命令 zellij run -- htop # 运行 htop 的新窗格 zellij run -f -- htop # 浮动窗格 zellij run -f --width 80% --height 80% -- htop # 大小浮动 zellij run -i -- make build #就地（替换当前窗格） zellij run -c -- make test # 退出时关闭窗格 zellij run -s --anger-cmd # 启动暂停（按ENTER键运行） zellij run -n "build" -- make # 命名窗格 ### 编辑文件 zellij edit src/main.rs # 在 $EDITOR 窗格中打开 zellij edit -f src/main.rs # 浮动编辑器窗格 zellij edit -l 42 src/main.rs # 在第42行打开 ### 行动（来自外部或内部） zellij action new-pane # 新窗格 zellij action new-pane --floating # 新的浮动窗格 zellij action new-tab --name "build" # 命名新选项卡 zellij action go-to-tab 2 # 切换到选项卡 2 zellij action dump-layout # 将当前布局导出到标准输出 zellij action dump-screen /tmp/out.txt # 转储窗格内容 zellij action switch-mode Locked # 进入锁定模式 zellij actiontoggle-floating-panes # 切换浮动 zellij action rename-session "work" # 重命名会话 ### 设置实用程序 zellij setup --dump-config # 打印默认配置 zellij setup --dump-layout default # 打印默认布局 zellij setup --dump-layout Compact # 打印紧凑布局 zellij setup --dump-swap-layout default # 打印交换布局 zellij setup --generate-completionfish # 鱼完成 zellij setup --generate-auto-start Fish # 自动启动脚本 zellij setup --check # 验证配置 ### 方便的别名（来自 shell 补全）别名 |扩展到 ---|--- `zr` | `泽利运行--` `zrf` | `zellij 运行 --浮动 --` `泽` | `泽利编辑` ** ** ## 会话复活您的配置已启用复活（`session_serialization true`、`serialize_pane_viewport true`）。 **保存的内容**：布局、窗格结构、命令、可见视口、回滚。 **未保存的内容**：正在运行的进程。命令在复活时显示“Press ENTER to run...”。 zellij ls # 显示 EXITED 会话 zellij Attach # 重新启动它 zellij Attach --force-run-commands # 跳过 ENTER 确认 zellij delete-session # 永久删除序列化会话是缓存目录中人类可读的 KDL 布局文件。它们可以共享、修改或直接使用“zellij --layout”加载。 ** ** ## 浮动和堆叠窗格 **浮动**：`Ctrl p`然后`w`（切换）、`e`（嵌入/浮动）或`Alt f`（如果默认绑定） **固定浮动**：始终位于顶部的窗格（通过 CLI 固定：`zellij run -f --pinned -- cmd`） **堆叠**：堆栈中的窗格，其中仅展开焦点窗格。在布局中定义“stacked=true”。 ** ** ## 插件（内置）插件 |地点 |描述 ---|---|--- `标签栏` | `zellij:标签栏` |标签栏（1 行） `状态栏` | `zellij:状态栏` |带按键绑定提示的状态栏（2 行） `紧凑型条` | `zellij:紧凑型酒吧` |组合选项卡+状态（1 行） `跨行者` | `zellij:strider` |文件浏览器侧边栏 `会话管理器` | `zellij：会话管理器` |会话切换器+复活UI `文件选择器` | `zellij:strider` |文件选择器（基于 cwd） `配置` | `zellij：配置` |运行时配置编辑器 `插件管理器` | `zellij:插件管理器` |插件管理界面加载布局：窗格大小=1 无边框=true { 插件位置=“zellij：compact-bar” } ** ** ## 故障排除问题 |修复 ---|--- macOS Alt 键不起作用 |在终端应用程序中配置（iTerm2：配置文件 → 键 → 左侧选项 = Esc+）复制不起作用 |将 `copy_command "pbcopy"` 添加到配置中字体/字符问题 |使用 Nerd 字体或 `simplified_ui true` Ctrl+H 触发移动模式 |终端发送 Ctrl+H 作为退格键 — 在终端或 Zellij 中重新映射筑巢预防 |开始之前检查 `$ZELLIJ` 环境变量鼠标选择|按住 SHIFT 绕过 Zellij 鼠标捕获样式下划线颜色错误 |添加“styled_underlines false” 配置未加载 |检查 `zellij setup --check` 并验证路径 ### 鱼壳整合 # 嵌套预防（添加到config.fish或conf.d/）如果状态是交互的；并且未设置-q ZELLIJ zellij Attach -c 默认值结束 # 生成补全 zellij setup --generate-completion Fish > ~/.config/fish/completions/zellij.fish ### 环境变量变量|描述 ---|--- '泽利吉' |在会话内设置为“0”（用于防止嵌套） `ZELLIJ_SESSION_NAME` |当前会话名称 `ZELLIJ_CONFIG_DIR` |覆盖配置目录 `ZELLIJ_CONFIG_FILE` |覆盖配置文件 `ZELLIJ_AUTO_ATTACH` |自动附加到现有会话 `ZELLIJ_AUTO_EXIT` |当 Zellij 退出时退出 shell ** ** ## 布局创作快速参考布局{ // 应用于所有选项卡的选项卡模板默认选项卡模板{ 窗格大小=1 borderless=true { 插件位置=“zellij:tab-bar” } Children // ← 选项卡内容所在的位置窗格大小=2 borderless=true { 插件位置=“zellij:status-bar” } } 选项卡名称=“代码”焦点= true { 窗格 split_direction="垂直" { 窗格大小=“60%”名称=“编辑器”编辑=“src/main.rs” 窗格大小=“40%”split_direction=“水平”{ 窗格名称=“术语” 窗格名称=“测试”命令=“制作”{ args“测试”; } } } } 选项卡名称=“git”{ 窗格命令=“lazygit” } // 浮动窗格部分浮动窗格{ 窗格 x=“10%” y=“10%” 宽度=“80%” 高度=“80%” 名称=“划痕” } } ### 关键布局属性属性|适用于 |价值观 ---|---|--- `分割方向` |窗格| `“垂直”，“水平”` `尺寸` |窗格| `"50%"` 或固定整数（行/列） `命令` |窗格|要执行的命令 `参数` |命令窗格的子项 | `“arg1”“arg2”` `编辑` |窗格|文件路径（在 $EDITOR 中打开） `cwd` |窗格、选项卡、布局 |工作目录 `名称` |窗格、选项卡 |显示名称 `焦点` |窗格、选项卡|初始焦点为“true” ‘无国界’ |窗格| “true”隐藏框架 `退出时关闭` |窗格|命令退出时关闭 `开始暂停` |窗格|等待输入 `堆叠` |窗格|堆栈儿童 `插件位置` |子块 |插件网址 CWD组成：窗格cwd→选项卡cwd→布局cwd→执行目录。相对路径链；绝对路径覆盖。有关完整的操作参考、主题系统、交换布局和插件配置，请参阅 [reference.md]()。

泽利指南

包含技能