Rich 不能直接用 rich.print() 替代 print()，须显式创建 Console 实例并配置 color_system、soft_wrap 等参数，以适配终端、CI、管道等不同环境。
Rich 能显著提升 CLI 脚本的可读性和专业感，但直接套用 print() 替换会踩坑——核心在于别把 Rich.print() 当成普通 print 用，得配合 Console 实例和上下文感知来控制输出节奏与样式。
为什么不能直接用 rich.print() 替代内置 print()
因为 rich.print() 默认使用全局 Console 实例，不支持动态切换颜色主题、禁用富文本（如 CI 环境）、或重定向到文件时自动降级。一旦脚本被管道捕获（python script.py | grep "error"），默认行为可能崩溃或输出乱码。
- 必须显式创建
Console实例：console = Console(color_system="auto", soft_wrap=True) - 检测是否在终端中运行：
if console.is_terminal:再启用高亮/进度条 - 写入日志文件时，用
console.record = True+console.export_text()提取纯文本
用 console.rule() 和 console.status() 构建清晰流程节点
自动化脚本最怕“卡在哪一步”。用 rule() 分隔阶段，用 status() 显示实时动作，比一堆 print("✅ Step 2 done") 更可靠。
with console.status("正在连接数据库...", spinner="dots"):
time.sleep(1.2)
console.rule("[bold green]数据库连接成功[/]", align="left")
-
spinner参数支持"bouncingBall"、"aesthetic"等 20+ 种，避免硬编码动画逻辑 -
rule()的align设为"left"可防止长标题截断 - 状态块必须用
with语句，否则退出时不自动清除光标行
表格输出慎用 console.table()，优先选 Table 类手动控制
console.table() 简单但僵硬：列宽自适应不可控、无法合并单元格、排序需额外处理。自动化脚本常需导出 CSV 或对齐数值列，这时必须用 Table。
立即学习“Python免费学习笔记（深入）”；
table = Table(show_header=True, header_style="bold magenta")
table.add_column("ID", style="dim", width=4)
table.add_column("Name", min_width=15)
table.add_column("Status", justify="right")
table.add_row("1", "backup-202405", "[green]✓ OK[/]")
console.print(table)
- 数值列用
justify="right"对齐，避免小数点错位 -
min_width比width更安全，防止内容过长时表格撑破终端 - 表头样式用
header_style单独设，别混在add_column()里
错误提示必须带 console.print_exception()，而非手拼 traceback
用户执行失败时，只打印 "Error: failed to read config" 是无效的。Rich 的异常渲染能保留源码上下文、高亮错误行、折叠无关帧。
try:
load_config()
except ConfigError as e:
console.print_exception(show_locals=True, max_frames=3)
raise SystemExit(1)
-
show_locals=True显示变量值，但生产环境建议关掉（防敏感信息） -
max_frames=3限制堆栈深度，避免刷屏；CLI 工具通常只需最近 3 层 - 别用
traceback.print_exc()—— 它不识别 Rich 主题，颜色全丢
真正难的是让 Rich 在不同环境（本地终端 / GitHub Actions / Docker 日志流）下表现一致：颜色开关、宽度计算、字符集兼容性都得靠 Console 初始化参数兜底，而不是依赖运行时探测。
