在终端环境中，我们可以通过在print函数的输出字符串中嵌入ANSI转义序列，让输出的文本显示不同的颜色和样式，但在Jupyter Notebook或Jupyter Lab中直接运行同样的代码，往往只能看到原始的转义字符，无法得到彩色的显示效果。这是因为Jupyter的输出渲染逻辑和原生终端不同，默认不会解析ANSI转义序列。
为什么Jupyter默认不支持ANSI彩色输出
ANSI转义序列是一组以 33[开头的特殊字符组合，终端会识别这些序列并调整后续文本的颜色、背景、加粗等样式。而Jupyter的输出是经过HTML渲染的，默认会将文本内容中的特殊字符直接展示，不会解析ANSI转义序列，因此原本的彩色设置会失效。
基础方法：手动转换ANSI序列为HTML样式
我们可以通过自定义函数，将ANSI转义序列映射为对应的HTML样式标签，再使用IPython的显示功能输出转换后的内容，实现彩色效果。
ANSI颜色到HTML的映射规则
常见的ANSI前景色代码对应的HTML颜色值如下：
| ANSI代码 | 颜色描述 | HTML颜色值 |
|---|---|---|
| 31 | 红色 | #FF0000 |
| 32 | 绿色 | #00FF00 |
| 33 | 黄色 | #FFFF00 |
| 34 | 蓝色 | #0000FF |
| 35 | 紫色 | #FF00FF |
| 36 | 青色 | #00FFFF |
转换函数实现
下面是一个简单的转换函数示例，支持常见的前景色设置：
import re
from IPython.display import HTML, display
def ansi_to_html(text):
# 匹配ANSI转义序列的正则表达式
ansi_pattern = re.compile(r' 33[(d+)m')
# 颜色映射字典
color_map = {
'31': '#FF0000',
'32': '#00FF00',
'33': '#FFFF00',
'34': '#0000FF',
'35': '#FF00FF',
'36': '#00FFFF',
'0': '' # 重置序列，对应关闭样式
}
result = []
last_end = 0
for match in ansi_pattern.finditer(text):
# 添加转义序列之前的普通文本
result.append(text[last_end:match.start()])
code = match.group(1)
if code in color_map:
if code == '0':
# 重置样式，关闭span标签
result.append('</span>')
else:
# 开启对应颜色的span标签
result.append(f'<span style="color: {color_map[code]}">')
last_end = match.end()
# 添加最后一段普通文本
result.append(text[last_end:])
# 组合所有内容，返回HTML对象
return HTML(''.join(result))
# 测试彩色输出
color_text = " 33[31m这是红色文本 33[0m， 33[32m这是绿色文本 33[0m"
display(ansi_to_html(color_text))
更简便的方法：使用第三方库
手动实现转换规则比较繁琐，我们可以使用成熟的第三方库快速实现效果，常用的有colorama和termcolor，搭配Jupyter的适配设置即可使用。
使用colorama库
colorama库原本是用于跨平台终端彩色输出的，我们可以通过初始化时设置参数，让它在Jupyter中也能正常工作：
# 首先安装colorama：pip install colorama from colorama import init, Fore, Style # 初始化时设置strip=False，保留ANSI序列，同时配合Jupyter的渲染设置 init(strip=False) print(Fore.RED + "这是红色文本" + Style.RESET_ALL) print(Fore.GREEN + "这是绿色文本" + Style.RESET_ALL) print(Fore.BLUE + "这是蓝色文本" + Style.RESET_ALL)
运行上述代码后，还需要在Jupyter中执行以下代码开启ANSI渲染支持：
from IPython.core.interactiveshell import InteractiveShell InteractiveShell.ast_node_interactivity = "last_expr" # 开启ANSI转义序列的渲染 %config InteractiveShell.ansi_colors = 'Linux'
使用termcolor库
termcolor库可以更方便地设置文本颜色和样式，结合IPython的HTML输出即可实现彩色显示：
# 安装termcolor：pip install termcolor
from termcolor import colored
from IPython.display import display, HTML
def print_color(text, color):
# 将termcolor生成的带ANSI序列的文本转换为HTML
ansi_text = colored(text, color)
# 简单替换常见颜色序列为HTML样式
html_text = ansi_text.replace(' 33[31m', '<span style="color:red">')
.replace(' 33[32m', '<span style="color:green">')
.replace(' 33[34m', '<span style="color:blue">')
.replace(' 33[0m', '</span>')
display(HTML(html_text))
print_color("红色提示信息", "red")
print_color("绿色成功信息", "green")
print_color("蓝色普通信息", "blue")
Jupyter Lab中的额外设置
如果你使用的是Jupyter Lab，可能还需要安装对应的扩展来支持ANSI渲染：
# 安装Jupyter Lab的ANSI渲染扩展 jupyter labextension install @jupyterlab/ansi-highlight
安装完成后重启Jupyter Lab，直接运行带ANSI转义序列的print代码就可以看到彩色效果了。
注意事项
- 使用手动转换方法时，如果ANSI序列包含背景色、加粗、下划线等复杂样式，需要补充对应的映射规则，否则可能无法正常显示。
- 第三方库的方法可能存在版本兼容问题，如果遇到失效的情况，可以检查库的版本和Jupyter的版本是否匹配。
- 不要在生产环境的代码中使用过于复杂的彩色输出逻辑，避免增加不必要的维护成本。
PythonJupyterprintANSI_colorescape_sequence修改时间：2026-06-10 18:48:38