Pi 中文文档

    tmux 设置

    本页面是 Pi 官方文档 的中文翻译。仅供学习参考。

    推荐配置

    添加到 ~/.tmux.conf：

    set -g extended-keys on
set -g extended-keys-format csi-u

    然后完全重启 tmux：

    tmux kill-server
tmux

    为什么推荐 csi-u

    仅使用 set -g extended-keys on 时，tmux 默认使用 extended-keys-format xterm。当应用请求扩展按键报告时，修饰键以 xterm 的 modifyOtherKeys 格式转发。使用 extended-keys-format csi-u 时，相同的按键以 CSI-u 格式转发，更可靠。

    Pi 支持两种格式，但对于 tmux 推荐使用 csi-u。

    这修复了什么

    没有 tmux 扩展按键时，带修饰的 Enter 键会退化为旧版序列：

    按键无扩展按键有 csi-u
    Enter\r\r
    Shift+Enter\r\x1b[13;2u
    Ctrl+Enter\r\x1b[13;5u
    Alt/Option+Enter\x1b\r\x1b[13;3u

    这影响默认快捷键（Enter 提交，Shift+Enter 换行）和任何使用修饰 Enter 的自定义快捷键。

    要求

    • tmux 3.2 或更高版本（tmux -V 检查）
    • 支持扩展按键的终端模拟器：Ghostty、Kitty、iTerm2、WezTerm、Windows Terminal

    法律声明：本页面是 pi.dev 官方文档的中文翻译版本，仅供学习参考。本网站与 pi.dev 及 Earendil Inc. 无任何法律关系。