Zellij: Rust 编写的现代终端复用器¶

Session (会话)
└── Tab (标签页，类似浏览器标签)
    └── Pane (窗格，标签页内的分屏)
        └── 你的 Shell 或程序

brew install zellij

# Arch Linux
pacman -S zellij

# 通过 Cargo
cargo install --locked zellij

# 直接下载二进制
curl -L https://github.com/zellij-org/zellij/releases/latest/download/zellij-x86_64-unknown-linux-musl.tar.gz | tar xz
sudo mv zellij /usr/local/bin/

# 生成默认配置
zellij setup --dump-config > ~/.config/zellij/config.kdl

// ~/.config/zellij/config.kdl

// 主题
theme "catppuccin-mocha"

// 默认模式
default_mode "normal"

// 默认布局
default_layout "compact"

// 鼠标支持
mouse_mode true

// 简化 UI
simplified_ui false

// 底部提示栏
pane_frames true

// 复制到系统剪贴板
copy_on_select true
copy_command "xclip -selection clipboard"  // Linux
// copy_command "pbcopy"  // macOS

// 空闲超时（秒）
scrollback_lines_to_serialize 10000

// 主题自定义
themes {
    my-theme {
        fg "#c0caf5"
        bg "#1a1b26"
        black "#15161e"
        red "#f7768e"
        green "#9ece6a"
        yellow "#e0af68"
        blue "#7aa2f7"
        magenta "#bb9af7"
        cyan "#7dcfff"
        white "#a9b1d6"
        orange "#ff9e64"
    }
}

// ~/.config/zellij/config.kdl (续)

keybinds {
    // 在 Normal 模式下的自定义绑定
    normal {
        bind "Alt h" { MoveFocusOrTab "Left"; }
        bind "Alt l" { MoveFocusOrTab "Right"; }
        bind "Alt j" { MoveFocus "Down"; }
        bind "Alt k" { MoveFocus "Up"; }
        bind "Alt n" { NewPane; }
        bind "Alt t" { NewTab; }
    }

    // 覆盖 tmux 模式的绑定
    tmux {
        bind "h" { MoveFocus "Left"; SwitchToMode "Normal"; }
        bind "l" { MoveFocus "Right"; SwitchToMode "Normal"; }
    }
}

# 直接启动
zellij

# 以指定名称创建会话
zellij -s my-project

# 使用特定布局启动
zellij --layout dev

# 附加到已有会话
zellij attach my-project

# 列出所有会话
zellij list-sessions
# 简写
zellij ls

# 1. 创建项目会话
zellij -s my-web-app

# 2. 底部提示栏显示可用操作
# 按 Ctrl+P → 显示窗格操作选项
# 按 d → 向右分屏

# 3. 左侧编辑代码
vim src/main.rs

# 4. 右侧运行程序
# Ctrl+P → n → 向下分屏
cargo run

# 5. 右下角看日志
tail -f app.log

# 6. 断开连接（SSH 断开后会话不丢失）
zellij detach
# 或 Ctrl+O → d

# 7. 重新连接
zellij attach my-web-app

// ~/.config/zellij/layouts/dev.kdl

layout {
    // 默认分屏方向
    default_tab_template {
        pane size=1 borderless=true {
            plugin location="tab-bar"
        }
        children
        pane size=2 borderless=true {
            plugin location="status-bar"
        }
    }

    tab name="editor" focus=true {
        pane split_direction="vertical" {
            pane name="code" size="70%" {
                command "hx"
                args "."
            }
            pane split_direction="horizontal" {
                pane name="terminal" size="60%"
                pane name="logs" {
                    command "tail"
                    args "-f" "app.log"
                }
            }
        }
    }

    tab name="git" {
        pane {
            command "lazygit"
        }
    }

    tab name="docs" {
        pane
    }
}

zellij --layout dev
# 或
zellij --layout ~/.config/zellij/layouts/dev.kdl

Ctrl+P → w          打开浮动窗格
Ctrl+P → e          浮动 ↔ 嵌入切换
Ctrl+P → x          关闭浮动窗格
Alt+方向键           移动浮动窗格

// 在布局中使用插件
layout {
    pane split_direction="vertical" {
        pane size="20%" {
            plugin location="file:~/.config/zellij/plugins/my-plugin.wasm"
        }
        pane
    }
}

# 列出所有会话
zellij ls

# 附加到指定会话
zellij attach project-a

# 强制附加（踢掉其他连接）
zellij attach project-a --force-run-commands

# 删除会话
zellij delete-session project-a

# 删除所有会话
zellij delete-all-sessions

# 如果没有可用会话就创建新的
zellij attach -c my-session

// config.kdl
keybinds {
    // 使用 Ctrl+B 作为前缀键（和 tmux 一样）
    tmux {
        bind "%" { NewPane "Right"; SwitchToMode "Normal"; }
        bind "\"" { NewPane "Down"; SwitchToMode "Normal"; }
        bind "c" { NewTab; SwitchToMode "Normal"; }
        bind "x" { CloseFocus; SwitchToMode "Normal"; }
        bind "d" { Detach; }
    }
}

# 在 .bashrc 或 config.fish 中自动启动 Zellij
# Bash
if [ -z "$ZELLIJ" ]; then
    zellij attach -c default
fi

# Fish
if not set -q ZELLIJ
    zellij attach -c default
end

~/.config/zellij/layouts/