tennis是一款运行在终端里的 CSV 表格查看工具，它的招牌能力——自动布局（autolayout）——能让任何宽表优雅地装进你的终端窗口：超宽列被智能压缩、截断，窄列保持完整，边框与对齐分毫不差。本文带你从原理到源码，逐层拆解 tennis 的自动布局算法是怎么运作的。

为什么终端宽表这么难装？

想象你打开一份 20 列、每列平均 15 个字符的 CSV，总宽超过 300 列，而终端只有 80 列。传统cat直接溢出，手工截断又丑又累。

tennis 的解法是：先给每列量出"自然宽度"，再像发零花钱一样把终端宽度分出去——小列拿全份，大列分余粮，装不下的优雅截断。

先认识四个核心术语

算法的全部逻辑都建立在四个词上，定义来自 layout.rs 的文件头注释：

natural的测量发生在 format 阶段：逐格格式化数字时顺手更新natural，见 format.rs。这样布局阶段无需再遍历全表，性能更好。

autolayout 六步走：从预算到分配

核心入口在 layout.rs 的autolayout函数，流程如下：

1. 算预算（budget）：终端总宽减去边框"chrome"。边框开销由 border.rs 精确计算——左右边框 + 每个列分隔符 + 每列两侧的 padding，一分都不能少扣。
2. 按 natural 升序排序：先处理最窄的列。
3. 分出 big1 列：被用户标记为-b（big）的列先走，最多分到总预算的一半，且保证整体不溢出终端（见 apply_big1）。
4. narrow 阶段：遍历排序后的列，每列的"公平份额" = 剩余预算 ÷ 剩余列数。若某列natural不超过公平份额，它就是窄列，拿满自然宽度、扣减预算（见 narrow）。
5. wide 阶段：一旦遇到超公平份额的列，后面所有列进入宽列模式：均分剩余预算，除不尽的余数按每列 1 格逐一分掉（见 wide）。
6. 收尾：所有列宽至少保底 2 字符（MIN_COL），防止极端小终端下出现 0 宽列。

公平份额：一个直观的例子

假设终端宽 80 列，边框占 6 列，budget = 74，共 3 列，natural 分别为 8、10、30：

• 第 1 列（8）：公平份额 74÷3 ≈ 24 ≥ 8 → 窄列，拿满 8 格，budget 剩 66；
• 第 2 列（10）：公平份额 66÷2 = 33 ≥ 10 → 窄列，拿满 10 格，budget 剩 56；
• 第 3 列（30）：公平份额 56÷1 = 56 ≥ 30 → 窄列，拿满 30 格。

三列全部不截断，完美装下。但如果第 3 列 natural 是 70，那么轮到它时公平份额 56 < 70，触发宽列模式：它拿 56 格，超出部分由 truncate.rs 优雅截断成abc…。算法的巧妙之处：排序保证窄列优先足额，宽列"牺牲"得最少。

Big / Bigger / Biggest：手动放大某列

想重点看某几列？tennis 提供三级放大参数（见 main.rs）：

• -b <列名>（Big）：该列最多分到一半预算，但整体仍不溢出终端；
• -bb <列名>（Bigger）：该列宽度至少取p90 单元格宽度（第 90 百分位，见 p90_width），即绝大多数行都能看全，通常会让表格溢出终端；
• -bbb <列名>（Biggest）：该列直接拿到完整自然宽度——"就把数据给我看全！"

后两级允许溢出时，记得配合-p / --pager走分页器横向滚动。

三种宽度模式：autolayout 只是其一

入口函数 run 按ResolvedWidth分派三种策略：

也就是说，autolayout 只在"固定宽度"模式下启用；min/max是两条简单直接的快速通道。

快速体验：装进你的终端

# macOS brew install gurgeous/tap/tennis

Linux 用户可从 Release 下载二进制放入PATH，或按 Cargo.toml 执行cargo build从源码构建。然后试试：

tennis data.csv # 自动布局 + 自动主题 tennis data.csv -b note -p # 放大 note 列并分页 tennis data.csv --width max -p # 全宽展开 + 分页 tennis data.csv --peek # 快速看数据形状与列统计

写在最后

tennis 的自动布局没有复杂的多目标优化，而是一个朴素却高效的三步策略：量 natural → 扣 chrome → 窄列拿满、宽列分余粮。配合-b / -bb / -bbb三级放大和min / max宽度模式，覆盖了从"挤着看"到"看全"的全部需求。想继续深挖，建议按管线顺序阅读 middleware/ 目录：columns建列 →format量化 →layout布局 →truncate截断，每一步都有对应的单元测试（例如 layout.rs 的 tests 模块 覆盖了极小终端宽度、big 列等边界场景），是理解终端表格排版的绝佳范例。