如何让 print 在 Jupyter 和终端里都保持彩色 ANSI 输出

11次阅读

jupyter和终端中print保持ANSI彩色输出需确保环境支持、避免重定向破坏及正确使用转义序列:JupyterLab v3+原生支持;windows推荐windows Terminal并确认VT启用;禁用Logging/tqdm等库对ANSI的过滤;直接使用33[代码m格式最可靠;调试可用三色圆点验证。

如何让 print 在 Jupyter 和终端里都保持彩色 ANSI 输出

在 Jupyter 和终端中让 print 保持彩色 ANSI 输出,关键在于确保 ANSI 转义序列不被过滤或忽略,并且输出流支持颜色渲染。Jupyter 的内核(如 ipython)默认会处理 ANSI 颜色,但某些环境(如旧版 JupyterLab、Windows 终端配置不当、或使用了重定向/日志封装)可能导致颜色丢失。

确认终端和 Jupyter 环境支持 ANSI

Jupyter Notebook / JupyterLab(v3+)原生支持 ANSI 颜色;终端则需确认是否启用颜色支持:

  • linux/macOS 终端一般默认支持;检查 echo -e "33[31mred33[0m" 是否显示红色
  • Windows:推荐使用 Windows Terminal(非旧版 cmd),并确保 os.environ.get("TERM") 不为 "dumb";Python 3.7+ 在 Windows 上通常自动启用 VT 支持
  • 若在 vs code 的 Python 终端中颜色异常,尝试勾选设置中的 python.terminal.executeInFileDir 并重启终端

避免 print 被封装或重定向破坏 ANSI

某些库(如 loggingtqdm、或自定义日志捕获)会截获 sys.stdout 并丢弃 ANSI 序列:

  • 禁用 logging.basicConfig() 中的 force=True 或自定义 handler 时不要调用 strip_ansi() 类方法
  • 使用 tqdm 时加参数 disable=False, colour="green",避免设 file=sys.stdout 后又手动 flush 导致颜色失效
  • 若用了 contextlib.redirect_stdout,确保目标流支持 ANSI(例如写入 io.StringIO 就会丢失颜色)

用标准方式输出 ANSI,不依赖第三方库

直接使用 ANSI 转义序列最可靠,无需额外依赖:

  • 基础颜色示例:print("33[1;32mSuccess!33[0m")(粗体绿色)
  • 兼容性更强可写成 x1b[...mu001b[...m,效果相同
  • 避免用 colorama.init() —— 它在 Jupyter 中可能重复初始化或干扰内核的颜色处理器
  • 如需复用,可定义简单函数:
    def cprint(text, code): print(f"33[{code}m{text}33[0m")
    cprint("Error", "31;1") # 红色加粗

调试技巧:快速验证当前环境是否生效

运行以下代码,观察是否显示红、绿、蓝三色文字:

print("33[31m●33[0m 33[32m●33[0m 33[34m●33[0m")

如果只显示黑点,说明:

  • Jupyter 中可能是内核缓存问题 → 重启内核再试
  • 终端中可能是 NO_COLOR=1 环境变量启用 → 运行 unset NO_COLOR 后重开终端
  • Python 启动时加了 -E-B 参数 → 检查启动命令或 ide 运行配置
text=ZqhQzanResources