CentOS下Rust日志记录配置方法

在 CentOS 上配置 Rust 日志记录系统，其实比想象中要简单高效。只要把几个基础模块搭建好，整个流程就能顺畅运转起来。下面我们就一步步拆解这套标准操作——从添加依赖库到自定义输出格式，逐一详细说明。

第一步：在项目中引入两个核心依赖

在 Rust 生态中，处理日志最成熟的方案就是 log 与 env_logger 这对组合。前者作为日志门面，定义宏和接口；后者是具体实现，负责将日志输出到终端。在 Cargo.toml 的 [dependencies] 部分添加以下两行，版本号建议使用当前最新的稳定版：

[dependencies]
log = "0.4"
env_logger = "0.9"

虽然版本号看起来是 0.x，但这两个库已经足够稳定，被 Rust 社区大量项目广泛采用。

第二步：在程序入口处初始化日志记录器

初始化操作通常放在 main 函数的最前面。调用 env_logger::init() 之后，后续所有的 info!、error! 等宏才能正常工作。下面是一个完整示例：

use log::{info, error};

fn main() {
    // 初始化日志记录器
    env_logger::init();

    info!("程序启动");

    // 你的业务逻辑
    if let Err(e) = some_function() {
        error!("发生错误: {}", e);
    }
}

fn some_function() -> Result<(), &'static str> {
    // 一些可能出错的代码
    Err("示例错误")
}

注意顺序：init() 必须在任何日志宏调用之前执行，否则后面的日志将会被静默丢弃。

第三步：通过环境变量控制日志级别

这是 env_logger 的设计精髓——完全依赖环境变量驱动，无需修改代码即可切换日志输出粒度。如果只想看到 info 及以上级别的信息，启动前这样设置：

export RUST_LOG=info
./your_rust_program

调试时若需要查看 debug 甚至 trace 级别的输出，只需将值改为 export RUST_LOG=debug 或 trace 即可。这种机制在开发环境与生产环境之间切换非常便捷。

第四步：自定义日志输出格式

默认的输出格式偏工程风格，清晰易读。但如果你希望日志更美观（或直接输出 JSON 格式供其他系统解析），可以通过 RUST_LOG_STYLE 环境变量来调整：

export RUST_LOG_STYLE=pretty
./your_rust_program

除了 pretty（带颜色、对齐更工整），还支持 json（结构化输出）、iso8601（时间戳采用 ISO 格式）等风格。具体选择取决于下游工具的需求。

第五步：将日志输出到文件或其他目标

默认情况下 env_logger 只向 stderr（标准错误输出）写入日志，适合在终端调试时直接查看。但如果需要写入文件、按日期滚动、或发送给远程收集服务，就需要使用 log4rs 或 tracing 等更重量级的日志库。它们支持配置文件、多输出目标、异步写入等高级功能，更适合生产环境。

总结来说，在 CentOS 上搭建 Rust 日志系统，核心步骤只有三个：添加依赖、调用初始化、设置环境变量。对于大多数场景，这套组合已经足够使用。如果后续有更复杂的需求（如文件切分、性能优化），再考虑迁移到 log4rs 或 tracing 也不迟。