Python 实现终端彩色日志输出的转义序列详解

码头散步
码头散步
发布时间:2026-10-13 | 6人浏览过
原创

本文详解如何利用 ANSI 转义序列在 Python 终端中实现不同日志级别的颜色显示。通过解析 \033[ 开头的控制码,可自定义前景色、背景色及高亮效果。文中提供了具体的 Python 代码示例,包括基于 logging 模块的封装类和直接打印的函数实现,帮助开发者优化命令行调试体验。

Python 终端彩色日志输出概述

本文介绍一种在 Python 中根据日志级别打印不同颜色日志的方法,旨在提升终端输出的可读性。


# -*-coding:UTF-8-*-
import logging
import os
import time
 
 
class logger(object):
  
  """
  终端打印不同颜色的日志,在pycharm中如果强行规定了日志的颜色, 这个方法不会起作用, 但是
  对于终端,这个方法是可以打印不同颜色的日志的。
  """ 
 
  #在这里定义StreamHandler,可以实现单例, 所有的logger()共用一个StreamHandler
  ch = logging.StreamHandler()
  def __init__(self):
    self.logger = logging.getLogger()
    if not self.logger.handlers:
      #如果self.logger没有handler, 就执行以下代码添加handler
      self.logger.setLevel(logging.DEBUG)
      from serviceProgram.utils.FileUtil import FileUtil
      rootPath = FileUtil.getProgrameRootPath()
      self.log_path = rootPath + '/logs'
      if not os.path.exists(self.log_path):
        os.makedirs(self.log_path)
 
      # 创建一个handler,用于写入日志文件
      fh = logging.FileHandler(self.log_path + '/runlog' + time.strftime("%Y%m%d", time.localtime()) + '.log', encoding='utf-8')
      fh.setLevel(logging.INFO)
 
      # 定义handler的输出格式
      formatter = logging.Formatter('[%(asctime)s] - [%(levelname)s] - %(message)s')
      fh.setFormatter(formatter)
 
      # 给logger添加handler
      self.logger.addHandler(fh)
 
  def debug(self, message):
    self.fontColor('\033[0;32m%s\033[0m')
    self.logger.debug(message)
 
  def info(self, message):
    self.fontColor('\033[0;34m%s\033[0m')
    self.logger.info(message)
 
  def warning(self, message):
    self.fontColor('\033[0;37m%s\033[0m')
    self.logger.warning(message)
 
  def error(self, message):
    self.fontColor('\033[0;31m%s\033[0m')
    self.logger.error(message)
 
  def critical(self, message):
    self.fontColor('\033[0;35m%s\033[0m')
    self.logger.critical(message)
 
  def fontColor(self, color):
    #不同的日志输出不同的颜色
    formatter = logging.Formatter(color % '[%(asctime)s] - [%(levelname)s] - %(message)s')
    self.ch.setFormatter(formatter)
    self.logger.addHandler(self.ch)
 
 
if __name__ == "__main__":
  logger = logger()
  logger.info("12345")
  logger.debug("12345")
  logger.warning("12345")
  logger.error("12345")

ANSI 转义序列原理

具体实现原理如下:

终端字符颜色的控制依赖于转义序列,这是文本模式下的系统显示功能,与具体编程语言无关。

转义序列以 ESC 字符开头,在 Python 字符串中通常使用 \033 来表示(ESC 的十进制 ASCII 码为 27,八进制为 033)。

其基本书写格式由开头部分和结尾部分组成。

开头部分格式为:\033[显示方式;前景色;背景色m;结尾部分格式为:\033[0m。

需要注意的是,开头部分包含显示方式、前景色和背景色三个参数,这三个参数均为可选,用户可根据需求只指定其中一个或多个。

由于表示不同含义的数值是唯一的且无重复,因此这三个参数的书写顺序没有固定要求,系统均能正确识别。

尽管顺序灵活,但建议遵循默认的格式规范进行书写,以提高代码的可读性和兼容性。

对于结尾部分,虽然可以省略,但为了保持书写规范的完整性,建议始终使用 \033[*** 开头,并以 \033[0m 结尾。

以下是数值参数所代表的具体含义:

常见的开头格式示例如下:

  • \033[0m 表示默认字体正常显示,不进行高亮处理。
  • \033[32;0m 表示红色字体正常显示。
  • \033[1;32;40m 表示显示方式为高亮,字体前景色为绿色,背景色为黑色。
  • \033[0;31;46m 表示显示方式为正常,字体前景色为红色,背景色为青色。

代码实现与示例

以下是具体的代码应用实例:

(1) print("\033[1;31;40m您输入的帐号或密码错误!\033[0m")

上述代码的输出效果为:字体高亮,红色前景,黄色背景(注:前景色即字体颜色)。

(2) print("\033[0;31m%s\033[0m" % "输出红色字符")

上述代码的输出效果为:字体默认样式,红色前景。


LOG_INFO='INFO'
LOG_ERROR='ERROR'
LOG_WARNING='WARNING'
LOG_NOTIFY='NOTIFY'
LOG_DEBUG='DEBUG'
LOG_USER='USER'
 
def info_log(value):
  if log_level > 3:
    print("\033[0;37;40m%s\033[0m"%value)
 
def error_log(value):
  if log_level != 0:
    print("\033[0;31;40m%s\033[0m"%value)
 
def warning_log(value):
  if log_level > 1:
    print("\033[0;33;40m%s\033[0m"%value)
 
def debug_log(value):
  if log_level > 5:
    print("\033[0;34;40m%s\033[0m"%value)
 
def notify_log(value):
  if log_level > 2:
    print("\033[0;36;40m%s\033[0m"%value)
 
def user_log(value):
  if log_level > 4:
    print("\033[0;32;40m%s\033[0m"%value)
 
def ZLOG(log_type,value):
  switcher={
    'INFO':info_log,
    'ERROR':error_log,
    'WARNING':warning_log,
    'DEBUG':debug_log,
    'NOTIFY':notify_log,
    'USER':user_log
  }
  return switcher[log_type](value)
 
test="hello world"
ZLOG(LOG_INFO,"output info log %s"%test)

以上就是本文关于 Python 终端彩色日志输出的全部内容,希望能为读者的学习提供有益帮助,欢迎继续支持本站获取更多技术资源。

相关标签:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表