从 tui-rs 到 Ratatui：六个月打造 Rust TUI 的历程
内容提要
Ratatui 已成为 tui-rs 的官方继任者。文章回顾了六个月的发展历程：从讨论分叉、创建 Discord、发布 0.20 至 0.22 版本，到原作者归档 tui-rs。新版亮点包括：条形图支持水平方向、Sixel 跳过能力、表格和列表的高亮间距配置、表格行对齐、滚动条轨道可选、每周自动发布 alpha 版、示例 GIF、通用 trait 实现、90% 测试覆盖率、禁止 unsafe 代码，以及正在编写的官方文档书。
延伸解读
从分叉到官方继任：社区驱动的项目交接
文章回顾了 Ratatui 如何从 tui-rs 的分叉讨论起步，最终获得原作者认可并归档原仓库。这一过程体现了开源社区在项目维护交接中的关键作用：先有未来讨论，再建立沟通渠道，原作者提出转移计划，随后创建分叉并持续开发，最终实现官方继任。对于依赖 tui-rs 的开发者，这意味着迁移到 Ratatui 是受支持的路径，且已有项目开始迁移并获得积极反馈。
新版本功能亮点：更灵活的终端界面控制
Ratatui 0.23 版本引入了多项实用改进：条形图支持水平方向，便于更高效利用空间；Cell 组件新增 set_skip 方法，可避免缓冲区覆盖 Sixel 等图形协议渲染的图像；表格和列表新增 HighlightSpacing 配置，解决选中行时布局跳动的问题；表格行支持左中右对齐；滚动条轨道符号变为可选，并移至 symbols 模块。这些变化让开发者能更精细地控制终端界面布局与渲染。
工程实践：自动化发布、测试覆盖与安全约束
项目每周六自动发布 alpha 版，版本号格式为 v<version>-alpha.<num>，方便开发者提前测试不稳定特性。测试覆盖率已达到 90%，并且明确禁止使用 unsafe 代码，这有助于提升库的可靠性和安全性。此外，通过 strum 为枚举类型实现了 Display 和 FromStr，并为结构体/枚举尽可能实现 Debug、Clone、Copy 等通用 trait，降低了使用门槛。官方文档书也在编写中，为深入学习提供系统资料。
对开发者的实际影响：迁移与参与机会
对于现有 tui-rs 用户，Ratatui 已成为官方继任者，迁移可获得持续更新和社区支持。但需注意部分破坏性变更，例如滚动条 track_symbol 现在需要传入 Some("-")，符号模块路径也发生了变化。项目通过示例 GIF 和每周 alpha 版降低了尝试成本，并欢迎贡献者参与文档、示例和问题修复。加入 Discord 或 Matrix 可获取帮助并了解新项目动态。
Q&A
Ratatui 是怎么成为 tui-rs 官方继任者的？
2023 年 2 月，社区成员在 issue 中讨论分叉 tui-rs，随后创建 Discord 服务器并成立分叉。经过数月开发，原作者 Florian Dehau 于 2023 年 8 月 7 日归档了 tui-rs 仓库，Ratatui 正式成为官方继任者。
Ratatui 的版本发布节奏是怎样的？
Ratatui 每周六自动发布 alpha 版本（预发布版），版本号格式为 v<version>-alpha.<num>，例如 v0.22.1-alpha.2。稳定版本则按里程碑发布，如 0.20.0、0.21.0、0.22.0 等。
Ratatui 的条形图现在支持水平方向吗？
是的，Barchart 组件现在支持水平渲染条形。通过设置 Direction::Horizontal 属性即可，这在某些情况下能更有效地利用可用空间。
Ratatui 中如何控制表格和列表的高亮间距？
Table 和 List 组件新增了 HighlightSpacing 属性，可通过 highlight_spacing 方法设置。有三种变体：Always（总是为选择符号预留间距）、WhenSelected（仅当有选中项时预留）、Never（从不预留）。
Ratatui 对 unsafe 代码有什么政策？
Ratatui 现在禁止使用 unsafe 代码，以确保内存安全和代码可靠性。
Ratatui 的测试覆盖率达到了多少？
Ratatui 目前的测试覆盖率达到了 90%，这得益于社区成员为各种组件添加的测试和基准测试。
Ratatui 有官方文档书吗？
是的，Ratatui 团队正在编写一本官方文档书，提供更深入的文档和使用示例，可以在 https://ratatui.rs/introduction/ 阅读。
