如何在 Rich 表格中仅隐藏右侧边框(自定义 Box 样式教程)

rich 的 `table` 不支持直接关闭单侧边框(如仅隐藏右边界),但可通过继承 `rich.box.box` 自定义边框字符实现,本文详解如何创建仅显示上、左边界(无右/下边界)的极简表格样式。

Rich 的 Table 类通过 box 参数控制整体边框外观,该参数接收 rich.box.Box 的子类实例(如 box.SQUARE, box.MINIMAL)。官方预设样式均为“全包围”设计,不提供按方向启停单边的功能——这意味着无法通过 border_style(仅控制颜色/粗细)或简单配置实现“仅保留顶部和左侧边框”。但 Rich 的设计高度可扩展:所有边框样式本质是 Box 类中 8 个 Unicode 字符属性(如 top, left, right, bottom, top_left, top_right, bottom_left, bottom_right)的组合。我们只需继承 Box 并将不需要的边设为空字符串 "" 即可。

以下是一个完整示例,定义一个仅渲染上边框(top)和左边框(left)、其余边完全隐藏的自定义 Box:

from rich.table import Table
from rich.box import Box
from rich.console import Console

# 自定义 Box:仅保留 top 和 left,其余为空
class TopLeftOnly(Box):
    def __init__(self):
        super().__init__(
            # 横向连接符(用于表头分隔线)
            head_row=chr(0x2500),  # ─
            # 纵向连接符(用于列分隔线)
            side="",
            # 四角与交叉点(全部设为空,避免多余符号)
            top_left="",
            top_right="",
            bottom_left="",
            bottom_right="",
            # 四边主线条
            top=chr(0x2500),       # ─(顶部横线)
            bottom="",             # 无底边
            left=chr(0x2502),      # │(左侧竖线)
            right="",              # 无右边
            # 内部交叉点(如行列交汇处)
            middle_vertical="",
            middle_horizontal="",
            cross="",
            down_right="",         # 从上到右的转角(不用)
            down_left="",          # 从上到左的转角(不用)
            up_right="",           # 从下到右的转角(不用)
            up_left="",            # 从下到左的转角(不用)
            vertical_right="",     # 竖线接右横线(不用)
            vertical_left="",      # 竖线接左横线(不用)
            horizontal_down="",    # 横线接下竖线(不用)
            horizontal_up="",      # 横线接上竖线(不用)
        )

# 使用示例
console = Console()
table = Table(title="Top-Left Only Table", box=TopLeftOnly(), show_header=True)
table.add_column("Name", style="cyan")
table.add_column("Role", style="magenta")
table.add_row("Luke", "Jedi")
table.add_row("Leia", "General")

console.print(table)

⚠️ 关键注意事项

  • box 参数必须传入 Box 实例(非字符串或样式名),border_style 仅影响颜色/亮度,无法控制边框存在与否
  • 若需表头分隔线(─),请保留 head_row 字段(如示例中设为 chr(0x2500));若连表头线也想隐藏,可将其设为 "";
  • side 控制列间竖线,默认为 │;若希望列之间也无分隔,可设为 "";
  • 所有 *left/*right/*up/*down 字段均需显式置空,否则默认值可能意外渲染残留符号;
  • 自定义 Box 不影响单元格内容对齐、样式或数据逻辑,仅改变外框视觉结构。

通过此方法,你不仅能实现“仅顶部+左侧边框”,还可自由组合任意边框组合(如仅底部+右侧、仅四角无边等),真正掌握 Rich 表格边框的底层定制能力。