TUI 边框的一格代价:Ratatui 维护者的 cell-border 协议提案与 Ghostty 原型

开源Rust

2026 年 11 月 13 日,Ratatui 维护者 joshka 在个人博客发布了一篇终端边框协议提案:让边框线画在字符格的边缘上,作为单元格属性存在,而不再占用一整行或一列的字符位。配套的 Ghostty 补丁和 Ratatui 演示分支已经能跑。这篇帖子当天登上 Hacker News 首页,拿到 253 分和 95 条评论,Lobsters 上同步出现了 44 分的讨论帖。

一个 TUI 框架的维护者动手去改终端协议,动机要从终端画框的现状说起。

cell borders 与 box drawing 的同屏对比

盒绘字符的四笔账

终端里画框的常规做法是 Unicode 盒绘字符块(Box Drawing block),这一块区有 128 个字符,涵盖直线、角和连接符。joshka 维护 Ratatui 期间见过大量 TUI 项目,多数界面长得相似:无聊背景上摆着几个素框。问题的根源之一在于,边框必须占空间,而空间在终端里是按行和列计价的。

他算的第一笔账是屏幕面积。在一台 16 寸笔记本上,用一款读得下去的字体,终端窗口大约是 200 列 × 50 行。列在这个尺寸下通常够用,行不够。一个带两层嵌套面板的布局,很容易把 50 行里的 6 到 8 行花在纯装饰线上。屏幕的六分之一到近五分之一,画的还是线。

第二笔账是位置的精度。盒绘字符是文本,一条线就是一个占满整格的字形,所以两个都有内容的格子之间画不进线。给文本输入框在下划线位置压一条线、给按钮描一圈边框,都做不到,只能先在四周垫空白。圆角同样吃亏:角上的字形自带一种背景色,面板背景与周围不同时,四个角会各露出一小块颜色错误的方块。线的粗细和位置也由字体说了算,应用完全无法控制。

第三笔账在剪贴板。在框里选中一段文字复制出来,框也在里面。每个把 TUI 输出贴进 Slack 的人都要做一遍删竖线的清理动作。表格贴进聊天工具时框也许有用,多数场景下它是垃圾。

第四笔账是图表。btop 风格的盲文图用点填满每个格子,格子本身就占满了,均值线或网格线没有地方可画,除非让出一整行。cell-border 方案下这些线可以画在格与格的边上:

btop 风格监控图,网格线与均值线画在格子边缘

把边框从字符降级为属性

提案的核心思路一句话可以讲完:cell border 是一种单元格属性,和背景色同级,不再是字符。每个单元格最多携带 12 条线段,四条边各分上下或左右两半,再加从中心伸出的四条臂。每条线段有独立的颜色、宽度、位置和样式,终端把它们绘制在字符网格之上。

边框存在单元格里,随之滚动、擦除、插入和 reflow,处理方式与颜色属性完全一致。把每条边拆成两半,是为了对齐象限块字符(▖▗▘▝ 一族),这样比格子小一半的图形也能描出一圈整齐的边。按同样的思路还能扩展到六分块、八分块,或四分之一、八分之一线宽。

线型支持实线、双线、虚线、点线。每个角和中心可选方形或圆角,圆角半径可配,还有抗锯齿弧线;圆角可以声明一种外部颜色,面板背景与背后内容不同时,弧线外的区域也能涂对颜色。

DCS 线格式与能力探测

传输层是一个带命名空间的 DCS 字符串:

text
ESC P 1 + b cell-border ; OP ; FIELDS... ESC \

最常用的路径是笔(pen)模型,像当前背景色一样挂在光标上。设好笔再打印文本,打印出来的格子就带上边框:

text
ESC P 1 + b cell-border;pen;48;32;7aa2f7;0;0 ESC \   (设笔:底边,蓝色)
hello
ESC [ 0 m                                            (SGR 0 清掉笔)

此外还有对已存在格子设边框或清除边框的矩形命令,以及一次能力查询。应用先发查询再发 DA1,如果 DA1 的应答先到而没有 cell-border 回复,说明终端不支持,应用回退到盒绘字符并预留它们需要的空间。不认识这个 DCS 的终端会把它静默忽略,行为与其他未知 DCS 一致。最小实现只需要笔、矩形命令和实线三种能力;线型、圆角关节、优先级和外部颜色都作为能力回复里列出的扩展字段,未知字段直接忽略,留出后续加的空间。协议里那个 1 是 v1 的旧含义,即第一版愿意写下来的草稿,joshka 自己建议读成 v0.1。

谁赢:共享边上的优先级裁决

相邻两个格子都往公共边上放线时,两条线合并成一条。裁决顺序是优先级高的赢,然后是更宽的赢,再然后是右侧或下方的赢。这个规则服务一个具体场景:获得焦点的面板可以提高自己线条的优先级,无论邻居以什么顺序绘制,它的完整轮廓都保得住。joshka 的第一版规则是右侧和下方恒赢,直到聚焦面板的半圈轮廓被邻居吃掉才改成现在这样。

Ghostty 里的 1650 行

Ghostty 的实现改动约 1650 行,其中相当一部分是测试。每个格子加一个 16 位边框 ID,塞进本来就存在的填充字节里,格子尺寸不变,无边框的屏幕零额外开销。ID 指向一张全终端共享的边框集合表,每个集合约 100 字节。一个典型 TUI 只会用到少数几种集合;表不回收,最坏情况 65535 个 ID 全部用上,占用约 10 到 15 MB。渲染侧只对带边框的格子做额外工作,每个格子查四个邻居来解析公共边,改动一行会连带重建上下两行。直线是每格几个实心四边形;圆角更贵,抗锯齿弧要按边缘像素逐行画小四边形。这部分 joshka 明确说没有正式跑过分项基准,是他最想要第二双眼睛的地方。

tmux 与复用器的边界

提案里最难缠的边界情况是复用器。tmux 这类工具按自己对网格的理解重绘面板,透传这种序列只会把边框画错位置。不懂协议的复用器应当丢弃这些序列并自己应答 DA1,里面的应用随之回退盒绘,与在别处运行无异;懂协议的可以把边框当普通属性存起来再重绘。共享边上的冲突在终端渲染时按优先级规则裁决,应用写格子的顺序无关紧要。擦除、插入、删除的行为都沿用背景色的既有答案;滚动缓冲区、备用屏幕和 reflow 基本白拿,因为边框就长在格子里。

先例与替代方案

这不是全新想法。PDCurses 和 X/Open curses 有过类似属性(WA_TOP、WA_LEFT 一族),算最接近的先例,但没有底边(Win32 实现)、没有颜色、宽度或半边。IBM 3270 终端可以给整个输入字段描边。这些先例都给不出每条边独立颜色和宽度的线,完整对比写在提案的 rationale 文档里。

HN 评论区里另一个替代主张是 overstrike 模式(DECSET 20,VK100 上可用):把边框字符叠印在已有文本的格子上,mintty 是目前唯一实现的终端模拟器。joshka 的回应是 overstrike 会明显加大圆角配内部填充的实现难度,而且这条路线补不上提案里的其他能力。

两条主要分歧

HN 讨论里最大的分歧与协议本身无关:既然都要改终端协议和终端了,为什么不做更激进的事,比如一个为界面设计、而非为复现哑终端局限的语义化 UI 协议?joshka 的态度写在回复里:终端协议之所以好用,是因为往里加东西的摩擦成本极高,他不想把这个特性做成 Web 那样的厨房水槽。另一条分歧是审美:有评论者更喜欢边框与内容之间留呼吸感的传统布局,边框要占格恰好迫使界面克制。

试用入口

spec 和 rationale 放在 Ghostty fork 的 joshka/cell-borders 分支上,该分支实现了 version 1 的全部内容,目前只在 macOS 上构建和运行过。构建需要 Zig 0.17 和 Xcode。仓库里的 gallery 脚本先探测支持再画样式长廊,兼作其他终端实现与否的快速检测。tiling panes 演示在 Ratatui 的同名分支上,终端不支持时自动回退盒绘,对比截图就是这么做的。joshka 在文末向两类人征集反馈:做终端的,哪部分实现起来贵;做 TUI 库或应用的,哪些控件想用、还缺什么。

提案要成为不止一个终端的特性,还要过终端作者这一关。它现在是一份能跑的草稿,加上一份写明了取舍理由的规范文档。

盒绘字符版本的同屏对比:每个面板上下左右各让出一行一列

来源:Terminal borders that don't cost a cell(joshka.net)、Hacker News 讨论、Lobsters 讨论、Ghostty fork joshka/cell-borders 分支