使用tracing-appender时如何避免输出带颜色控制字符？

你看到的[2m、[0m、[34m类字符是ANSI终端控制码，用于控制终端输出的文字颜色、粗细、背景色等样式。tracing 生态默认会为终端输出启用该特性，写入文件时没有单独关闭就会残留这类字符，导致文本查看时显示异常。

方案1：从源头禁用文件输出的ANSI颜色（推荐） #

在初始化 tracing 订阅器时，为输出到文件的 fmt 层单独添加with_ansi(false)配置即可从生成侧避免控制字符产生，无额外性能开销。
参考代码示例：

use tracing_appender::rolling::{RollingFileAppender, Rotation};
use tracing_subscriber::{fmt, prelude::*};

fn main() {
    // 初始化滚动日志文件输出器
    let file_appender = RollingFileAppender::new(Rotation::DAILY, "./logs", "app.log");
    let (non_blocking_file_writer, _guard) = tracing_appender::non_blocking(file_appender);
    
    tracing_subscriber::registry()
        // 写入文件的日志层，显式关闭ANSI颜色输出
        .with(
            fmt::layer()
                .with_writer(non_blocking_file_writer)
                .with_ansi(false) // 核心配置，去除颜色控制字符
        )
        // 若同时需要终端输出保留颜色，可单独为终端输出层开启ANSI
        .with(
            fmt::layer()
                .with_writer(std::io::stdout)
                .with_ansi(true)
        )
        .init();
}

如果使用了自定义格式化插件，需要同步检查插件的独立颜色开关配置，关闭文件输出对应的颜色特性。

方案2：对已有历史日志做后处理清理 #

如果已经生成了大量带控制字符的历史日志，可以通过正则匹配批量移除ANSI控制序列：

• Linux/macOS 环境直接用 sed 命令处理单文件：
  sed -r "s/\x1B\[([0-9]{1,3}(;[0-9]{1,3})*)?[mGK]//g" 原始日志.log > 清理后日志.log
• 跨平台批量处理可以用Python脚本：

  import re
  import os
  
  # 匹配所有ANSI控制序列的正则
  ANSI_ESCAPE_PATTERN = re.compile(r'\x1B(?:[@-Z\\-_]|\[.*?[a-zA-Z])')
  
  def clean_single_log(input_path: str, output_path: str):
      with open(input_path, 'r', encoding='utf-8', errors='ignore') as f:
          raw_content = f.read()
      cleaned_content = ANSI_ESCAPE_PATTERN.sub('', raw_content)
      with open(output_path, 'w', encoding='utf-8') as f:
          f.write(cleaned_content)
  
  # 批量处理指定目录下所有.log后缀的文件
  if __name__ == '__main__':
      log_dir = "./logs"
      for file_name in os.listdir(log_dir):
          if file_name.endswith('.log') and not file_name.startswith('cleaned_'):
              input_path = os.path.join(log_dir, file_name)
              output_path = os.path.join(log_dir, f"cleaned_{file_name}")
              clean_single_log(input_path, output_path)
  

内容的提问来源于stack exchange，提问作者Viktor Kulikov