tmux 3.6 / 3.6b 升级要点：重启服务端、pane-scrollbars 与 Mode 2031

版本与链接

tmux 3.6 于 2025-11-26 发布，作者 Nicholas Marriott (nicm)。3.6b 是 2026-05-20 的 bug fix 版本。

• 仓库：
• Release：
• CHANGES：
• 讨论 issue：

升级后必须彻底重启 tmux

这是本版本最容易踩的坑。tmux 依赖的一个库更改了协议，旧的 tmux 服务端和新客户端之间不兼容。如果你在 attach 时看到报错，先怀疑是不是没重启。

处理方式是杀掉所有 tmux 服务端再启动：

tmux kill-server

或者在不影响其他会话的前提下分别重启。只重载配置（source-file）不够，必须换掉进程。

3.6 的主要变化

滚动条：新增 pane-scrollbars 选项，来自 Michael Grant，他同时还贡献了多项功能与修复。

Mode 2031 主题支持：终端向应用上报颜色方案，来自 Jonathan Slenders。

格式（format）操作符改进：

• 布尔表达式与 #?，来自 David Mandelberg；
• 循环操作符的排序，来自 Michael Grant；
• 新增 buffer、session、cursor 样式相关的变量。

tmux 请求/上报信息的能力扩展：

• 可发送像素尺寸查询（Dmitry Galchinsky）；
• 转发 OSC 4 调色板查询（Tim Culverhouse 推动）；
• 支持上报光标、鼠标、粘贴与焦点状态（Andrea Alberti）；
• 查询剪贴板支持（James Holderness）。

已知用户反馈（issue #4699）

条件格式语义变化。 有人从 3.5a 升级后，status-left 里的条件格式不生效。原因是条件中这一类合并写法行为变了：

#[fg=#cdd9e5,bg=#347d39]

拆成两段写就恢复正常输出：

#[fg=#cdd9e5]#[bg=#347d39]

这类格式表达式的语义调整需要在配置里逐个排查，尤其是把多个属性塞进一个 #[...] 的写法。

server exited unexpectedly。 出现在 pixi/conda 安装场景下，回退 3.4 可恢复，属个例。

水平分栏拖动与滚动条代码相关的 bug。 作者称已在仓库中修复，可以自行编译验证。

升级与排障建议

1. 升级前先记下当前版本（tmux -V），确认配置文件位置，方便出问题时回退。
2. 升级后执行 tmux kill-server，再重新起会话，不要依赖 attach 旧服务端。
3. attach 报错先排除协议不匹配，再去看配置。
4. 状态栏、窗口列表里出现输出异常时，检查 #[...] 中合并书写的 fg/bg 等属性，先拆开验证。
5. 遇到 server exited unexpectedly 这类个例，记录安装方式（pixi/conda 等）与版本，回退到 3.4 作为临时手段。
6. tmux 通常只在安全或明显的 showstopper bug 时才发补丁版本。如果你依赖滚动条或水平分栏拖动这些新代码路径，正式版发布前先测 master 更稳妥。