使用tracing_subscriber时日志文件出现ANSI转义字符的解决方法

核心原因 #

tracing_subscriber的默认格式器会自动检测输出目标是否为终端，若检测逻辑失效或手动启用了着色，ANSI转义字符就会被写入日志文件，导致格式混乱。

具体解决方法 #

方法1：显式禁用格式器着色 #

修改日志配置代码，在fmt()构建器中调用with_ansi(false)强制关闭ANSI着色：

use tracing_subscriber::{fmt, EnvFilter};

fn setup_logging() {
    let log_filter = EnvFilter::try_from_default_env()
        .unwrap_or_else(|_| EnvFilter::new("info"));

    fmt()
        .with_ansi(false) // 关键：禁用ANSI着色
        .with_env_filter(log_filter)
        .with_writer(std::fs::File::create("app.log").unwrap()) // 指定输出到文件
        .init();
}

方法2：针对特定格式禁用着色 #

若使用Compact或Pretty格式，同样通过with_ansi(false)关闭着色：

use tracing_subscriber::{fmt, EnvFilter};

fn setup_logging() {
    let log_filter = EnvFilter::try_from_default_env()
        .unwrap_or_else(|_| EnvFilter::new("info"));

    fmt()
        .compact() // 或.pretty()，根据你的格式选择
        .with_ansi(false)
        .with_env_filter(log_filter)
        .with_writer(std::fs::File::create("app.log").unwrap())
        .init();
}

方法3：通过环境变量控制 #

无需修改代码，设置环境变量强制关闭所有着色输出：

export RUST_LOG_STYLE=never
# 随后运行你的Rust程序

验证 #

重新运行程序后查看日志文件，ANSI转义字符（如^[[3m）会消失，日志将变为干净的纯文本格式。

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