Rich 终端富文本库

Rich 是什么

Rich 是一个 Python 库，用于在终端中输出富文本与精美排版。它为命令行程序带来颜色、样式、表格、进度条、Markdown 渲染、语法高亮和更易读的异常回溯，几乎开箱即用。

项目由 Textualize 维护，采用 MIT 协议，支持 Python 3.8+，可在 Linux、macOS、Windows 以及 Jupyter Notebook 中运行。

快速上手

安装后可直接用模块自检终端效果：

python -m pip install rich
python -m rich

最轻量的用法是替换内置 print：

from rich import print

print("Hello, [bold magenta]World[/bold magenta]!", ":vampire:")

需要更细粒度控制时，使用 Console 对象：

from rich.console import Console

console = Console()
console.print("Where there is a [bold cyan]Will[/bold cyan] there [u]is[/u] a [i]way[/i].")

主要能力

• Console：统一输出入口，支持自动换行、样式与标记语法。
• 表格与面板：用少量代码渲染对齐良好的表格、边框与布局。
• 进度条：为长任务提供可视化进度与耗时信息。
• 日志与 Logging Handler：带时间、文件与行号的日志输出，并可接管标准 logging。
• 语法高亮与 Markdown：直接在终端渲染代码与 Markdown 文档。
• Traceback 美化：让异常信息更清晰，定位问题更快。
• Inspect：对任意 Python 对象生成结构化报告，便于调试。

适用与注意

Rich 适合作为命令行工具、脚本和调试辅助的展示层。需要注意的是，经典 Windows 终端仅支持 16 色，真彩色与 emoji 需要新版 Windows Terminal；在极简脚本中引入该依赖也需权衡。