Big, Bigger, Biggest:深入解析tennis的-b/-bb/-bbb列宽扩展与pager组合拳
Big, Bigger, Biggest:深入解析tennis的-b/-bb/-bbb列宽扩展与pager组合拳
tennis 是一个在终端里打印样式化 CSV 表格的轻量级命令行工具,由 Rust 编写。它的自动布局(autolayout)会努力让表格塞进终端宽度,代价是长内容会被截断。当你想看全某一列时,-b、-bb、-bbb 这"三级火箭"列宽扩展参数配合 --pager 分页器,就能让 CSV 表格宽列完整呈现。
为什么终端 CSV 表格会被"截断"?
默认情况下,tennis 会探测你的终端宽度(探测不到就退回 80 列,见 src/render/resolved.rs),然后计算每列的"自然宽度",把窄列保留原宽、宽列平分剩余空间。这意味着列越多、内容越长,单列能分到的宽度就越少——长文本、长警告信息、长路径名往往只剩下一小截。
下面的多组数据截图展示了这种自动适配的效果:宽列被压缩、内容以 ... 截断,整张表始终贴合终端宽度:
布局的全部细节都在 src/middleware/layout.rs 中,文件头部还配有一段很形象的注释和术语表(natural、budget、narrow、wide)。
三级火箭:-b、-bb、-bbb 到底差在哪
tennis 用"Big, Bigger, Biggest"三级放大来手动干预列宽,三者都接逗号分隔的列名列表:
| 参数 | 级别 | 列宽策略 | 会不会撑爆终端? |
|---|---|---|---|
-b <headers> |
Bigger | 最多分到终端预算的一半,仍保持截断 | ❌ 不会,表格依旧贴合宽度 |
-bb <headers> |
BIGGER (p90) | 放大到第 90 百分位(p90)宽度,90% 的行完整可见 | ⚠️ 通常会超出终端 |
-bbb <headers> |
BIGGEST | 放大到整列"自然宽度",完全不再截断 | ⚠️ 必然超出终端 |
三档策略在 src/middleware/layout.rs 中实现:apply_big1 给 -b 列最多分一半预算;apply_big23 则让 -bb 列取"当前宽度和 p90 宽度"的较大者,让 -bbb 列直接取整列最大宽度。对应地,src/render/options.rs 里有一个 ColumnBig 枚举(Normal / Big / Bigger / Biggest)承载这四档状态。
几个容易踩的坑,先划重点:
- 🔎
-bb的 p90 不是"完整":它取的是 90% 分位数的单元格宽度,极少数特别长的行仍可能被截断。要看"百分之百不截断",请用-bbb。 - 📏
-bbb会横向溢出终端:此时不加分页器,内容就会在屏幕上"换行折断",观感很差——这就是 pager 登场的原因。
快速上手:一条命令把 CSV 列变宽
以仓库自带的测试数据为例。tests/pigeon-racing.csv 里有 Breeder、Pigeon 这类偏长的列,tests/spinel.jsonl 的 warnings、input 列则塞满了编译器长警告——是 -bbb 的绝佳试炼场:
# 温和放大:Speed 和 Breeder 最多各分到一半宽度,表格不溢出
tennis -b Speed,Breeder tests/pigeon-racing.csv
# p90 放大:warnings 列展示到 90% 行的完整长度
tennis -bb warnings tests/spinel.jsonl
# 完全展开:warnings 与 input 列整列不截断
tennis -bbb warnings,input tests/spinel.jsonl
列名也可以用序号指定(从 1 开始),解析逻辑在 src/grid.rs:
# spinel.jsonl 的第 2 列是 example,等价于 -bbb example
tennis -bbb 2 tests/spinel.jsonl
杀手组合拳:-bbb + --pager
-bb/-bbb 让表格变宽,但宽表在 80 列的终端里会横向溢出。此时加上 -p(--pager),tennis 会把整张表送进 $PAGER 环境变量指定的分页程序(未设置时默认 less -RS),你可以左右滚动、上下翻页地看完整内容:
tennis -bbb warnings,input -p tests/spinel.jsonl
分页器实现见 src/main.rs:读取 PAGER 环境变量启动子进程,把渲染好的表格写入其 stdin;less -RS 里的 -R 让终端里的颜色在分页模式下依然生效。
除了 -bbb,还有两种"变宽"姿势值得知道:
# 整张表按内容最大宽度渲染(取消所有截断),配合 -p 食用
tennis --width max -p tests/pigeon-racing.csv
# 手动指定一个超大宽度,只放大你关心的列
tennis --width 1000 -b Speed -p tests/pigeon-racing.csv
--width 还支持 min(按表头宽度布局)等取值,完整说明在 man page extra/tennis.1 中。下面这张动图演示了表格随窗口尺寸伸缩的自适应效果:
值得了解的实现细节
- 🏁
-bb不是标准的 clap 短参数:Rust 的 clap 无法原生区分-bb、-bbb,所以 tennis 在解析前先把它们改写成内部参数--_b2、--_b3,再把两行帮助文本插回-b之后。这段"小聪明"在 src/args.rs 的normalize_big_args里,--之后的-bb会被当作文件名,不会被改写。 - 🎚️ 参数优先级:三档参数可以叠加使用;对同一列,后出现的更高优先级生效(
big1→big2→big3依次覆盖,见 src/main.rs)。 - 🧮 p90 宽度含表头:
-bb的 90 百分位是在全部单元格显示宽度上插值计算(src/util.rs 的percentile),并与表头宽度取较大值,保证表头不会比数据更窄。
推荐工作流:先 peek,再决定放大哪一列
拿到一个陌生 CSV,先用 --peek 看形状和统计信息——它会给出行数×列数、每列的类型/填充率/最大长度,帮你判断哪一列值得加 -bbb:
tennis --peek your-file.csv # 先侦察
tennis -bbb <长列名> -p your-file.csv # 再精确放大 + 分页查看
小结
| 场景 | 推荐姿势 |
|---|---|
| 某几列稍微窄了点 | -b 列名,安全不溢出 |
| 想看 90% 行的完整内容 | -bb 列名,宽度可控 |
| 一列都不能截断(日志、警告、代码) | -bbb 列名 -p,完整 + 分页 |
| 整张表都不要截断 | --width max -p |
一句话记忆:-b 抢一半,-bb 取 p90,-bbb 给全部;全都要,就交给 pager。 更多布局参数可参考 README.md 的 "Big, Bigger, Biggest" 章节。



