Rich - Python 终端富文本和美化格式库#

技能概述#

本技能帮助用户使用 Rich 在 Python 终端程序中输出美观的富文本内容，支持以下场景：

• 彩色输出: 使用标记语法为文本添加颜色、样式和表情符号
• 表格渲染: 创建美观的 ASCII 表格，支持多种边框样式
• 进度条: 显示任务进度、下载进度、批量操作进度
• Markdown 渲染: 在终端中渲染 Markdown 文本
• 语法高亮: 对代码片段进行语法高亮显示
• 结构化日志: 替换标准 logging，输出格式化日志
• Python 对象美化打印: 替代 pprint，输出带颜色和折叠的对象

GitHub: https://github.com/Textualize/rich（56k+ Stars）

使用流程#

AI 助手将引导你完成以下步骤：

1. 安装 Rich（如未安装）
2. 选择合适的组件（Console、Table、Progress 等）
3. 编写代码并查看效果
4. 根据需求调整样式和配置

关键章节导航#

• 安装指南
• 快速开始
• 高级用法
• 常见问题

AI 助手能力#

当你向 AI 描述终端输出需求时，AI 会：

• 自动生成对应的 Rich 代码片段
• 选择最合适的 Rich 组件（Table/Panel/Progress 等）
• 调整颜色、样式等视觉参数
• 集成到现有项目代码中
• 处理不同终端环境的兼容性问题
• 将 print/logging 替换为 Rich 输出

核心功能#

• 支持 Console 对象统一管理终端输出
• 支持标记语法（Markup）设置文本样式
• 支持 16/256/True Color 颜色模式
• 支持 Table（表格）、Panel（面板）、Tree（树形）等渲染组件
• 支持 Progress（进度条）和 Live（动态刷新）
• 支持 Syntax（语法高亮）和 Markdown（文档渲染）
• 支持 Traceback（美化异常追踪）
• 支持 Inspect（对象检查）
• 支持 Logging Handler 集成
• 支持导出 HTML/SVG 终端截图

快速示例#

python

# 最简单的用法 - 使用全局 print
from rich import print
print("[bold magenta]Hello[/bold magenta], [green]World[/green]! :sparkles:")

# 使用 Console 对象
from rich.console import Console
console = Console()
console.print("[bold]Rich[/bold] is [italic green]awesome[/italic green]!")

# 美化打印 Python 对象
from rich import pretty
pretty.install()
{"name": "rich", "stars": 56000, "features": ["color", "table", "progress"]}

python

# 渲染表格
from rich.console import Console
from rich.table import Table

console = Console()
table = Table(title="Python 包对比")
table.add_column("名称", style="cyan", no_wrap=True)
table.add_column("Stars", style="magenta")
table.add_column("用途", style="green")
table.add_row("rich", "56k+", "终端美化")
table.add_row("click", "14k+", "命令行解析")
table.add_row("typer", "13k+", "CLI 框架")
console.print(table)

python

# 进度条
from rich.progress import track

for step in track(range(100), description="处理中..."):
    # 执行任务
    pass

安装要求#

• Python 3.8 或更高版本
• pip 包管理器
• 支持 ANSI 转义码的终端（macOS Terminal、iTerm2、Windows Terminal、Linux 各终端）

许可证#

MIT License

项目链接#

• GitHub: https://github.com/Textualize/rich
• 官方文档: https://rich.readthedocs.io
• PyPI: https://pypi.org/project/rich/
• 示例代码: https://github.com/Textualize/rich/tree/master/examples