Python彩色输出案例实操？

wen python案例 2026-06-06 20:01:18 6

Python彩色输出案例实操：从入门到炫酷命令行界面

目录导读

为什么需要彩色输出？
核心实现方案对比
实操案例一：ANSI转义序列（零依赖方案）
实操案例二：colorama库（跨平台方案）
实操案例三：rich库（高级富文本输出）
常见问题与解答
总结与最佳实践

为什么需要彩色输出？

在命令行界面（CLI）开发中，彩色输出不仅能提升视觉体验,更能：

快速定位信息：红色错误、绿色成功、黄色警告一目了然
提升用户交互：日志分级、进度条、菜单选择等场景
增强可读性：区分不同类型的数据，避免纯文本的枯燥

用户痛点：很多新手尝试用print实现彩色输出时，常遇到乱码、跨平台失效等问题，本文通过3个经典案例,手把手解决这些痛点。

核心实现方案对比

方案	依赖	跨平台	功能丰富度	适用场景
ANSI转义序列	无	部分兼容Win10+	基础颜色/样式	快速原型、简单标色
colorama	需安装	全平台（自动转换）	基础+重置	生产环境、兼容旧Windows
rich	需安装	全平台	高亮/表格/进度条/语法高亮	复杂CLI应用、数据分析

提示：Windows 10较老版本（<1511）可能需要colorama，Win11及Linux/MacOS原生支持ANSI。

实操案例一：ANSI转义序列（零依赖方案）

1 核心原理

ANSI转义序列以\033[（ESC字符）开头，以m格式为：

\033[样式;前景色;背景色m文本内容\033[0m

2 代码实现

class Color:
    RED = '\033[31m'
    GREEN = '\033[32m'
    YELLOW = '\033[33m'
    BLUE = '\033[34m'
    MAGENTA = '\033[35m'
    CYAN = '\033[36m'
    RESET = '\033[0m'
    BOLD = '\033[1m'
    UNDERLINE = '\033[4m'
def color_print(text, color=Color.RESET, style=''):
    print(f"{style}{color}{text}{Color.RESET}")
# 使用示例
color_print("成功！", Color.GREEN, Color.BOLD)
color_print("警告：磁盘空间不足", Color.YELLOW)
color_print("错误：文件不存在", Color.RED)

3 进阶：背景色与高亮

# 组合使用：黄底红字
print(f"\033[41;33m 紧急错误 \033[0m")

注意：在老旧Windows终端（cmd）中，可能需要先执行os.system('color')启用ANSI支持。

实操案例二：colorama库（跨平台方案）

1 安装与初始化

pip install colorama

2 代码实现

from colorama import init, Fore, Back, Style
# 自动转换Windows终端码（关键一步）
init(autoreset=True)  
print(Fore.RED + "红色文字")
print(Fore.GREEN + "绿色文字" + Fore.RESET)
print(Back.YELLOW + "黄底文字")
print(Style.BRIGHT + "加亮效果")

3 实战：带时间戳的日志系统

import datetime
from colorama import init, Fore, Style
init(autoreset=True)
def log(msg, level='INFO'):
    timestamp = datetime.datetime.now().strftime('%H:%M:%S')
    if level == 'ERROR':
        print(f"{Fore.RED}[{timestamp}] {msg}")
    elif level == 'WARN':
        print(f"{Fore.YELLOW}[{timestamp}] {msg}")
    elif level == 'SUCCESS':
        print(f"{Fore.GREEN}[{timestamp}] ✅ {msg}")
    else:
        print(f"{Fore.CYAN}[{timestamp}] {msg}")
log("服务启动成功", 'SUCCESS')
log("磁盘使用率85%", 'WARN')

实操案例三：rich库（高级富文本输出）

1 安装

pip install rich

2 核心功能示例

from rich.console import Console
from rich.table import Table
from rich.progress import Progress
from rich.markdown import Markdown
from rich.syntax import Syntax
console = Console()
# 彩色文本（自动检测终端支持）
console.print("红色", style="bold red")
console.print("蓝色背景", style="on blue")
console.print("带下划线", style="underline green")
# 表格输出
table = Table(title="用户数据")
table.add_column("ID", style="cyan")
table.add_column("姓名", style="magenta")
table.add_column("状态", style="green")
table.add_row("001", "张三", "✅ 激活")
table.add_row("002", "李四", "⏳ 待审核")
console.print(table)
# 进度条
with Progress() as progress:
    task = progress.add_task("[green]处理中...", total=100)
    for _ in range(100):
        progress.update(task, advance=1)
# 代码高亮
code = """
def hello():
    print("Hello World!")
"""
syntax = Syntax(code, "python", theme="monokai")
console.print(syntax)

3 适用场景建议

报告生成：用表格+颜色展示数据统计
CLI工具：带进度条的文件处理、网络下载
日志系统：支持时间戳、彩色级别的日志输出

常见问题与解答

Q1：为什么在Windows cmd中彩色输出显示为乱码？

A：Windows cmd默认不支持ANSI转义码，解决方案：使用colorama库（from colorama import init; init()）或升级到Windows 10 1511以上的PowerShell。

Q2：彩色输出如何跨平台一致？

A：推荐colorama或rich库，colorama自动转换Windows终端码,rich使用Unicode可视化方案确保跨平台一致性。

Q3：彩色输出会影响日志文件记录吗？

A：会影响，建议在日志文件中移除颜色控制符，可用rich的@logging模块或自定义过滤函数：import re; clean_text = re.sub(r'\033\[[0-9;]*m', '', raw_text)

Q4：如何自定义颜色？

A：ANSI支持256色：\033[38;5;编号m（前景色）或\033[48;5;编号m（背景色），编号范围0-255，常用如196=红色、82=绿色，rich直接支持CSS颜色名或十六进制：style="color: #ff6600"

Q5：性能开销大吗？

A：ANSI和colorama几乎无性能开销，rich因功能丰富，在大量连续输出时建议使用@rich.console的log方法或批量输出。

总结与最佳实践

选择建议

简单脚本：直接使用ANSI转义序列（配合os.name判断平台）
生产环境：colorama + 自定义日志类
复杂CLI：rich库（功能全、开发快）

代码规范

# 推荐统一封装
class Logger:
    def __init__(self, use_color=True):
        self.use_color = use_color
        self.colors = {...}  # 预定义颜色字典
    def info(self, msg):
        print(self._format(msg, 'blue'))
    def error(self, msg):
        print(self._format(msg, 'red'))

最终案例：一个彩色命令行计算器

from colorama import Fore, init
import sys
init(autoreset=True)
def calculator():
    print(Fore.CYAN + "=== 彩色计算器 ===")
    while True:
        try:
            expr = input(Fore.YELLOW + "请输入表达式（如 3+5）：")
            if expr.lower() == 'exit':
                break
            result = eval(expr)
            print(Fore.GREEN + f"结果：{result}")
        except:
            print(Fore.RED + "输入格式错误！")
if __name__ == "__main__":
    calculator()

通过以上三个层级的案例，你可以根据需求灵活选择，彩色输出不仅能提升用户体验，更是专业CLI工具开发的必备技能，现在就开始动手，让你的命令行程序“出彩”吧！

文章基于Python 3.9+版本测试，所有代码已验证，遇到兼容问题可检查终端版本或添加init(autoreset=True)。

标签： colorama