Rust语言日志实战指南（从零开始掌握log crate日志库）

什么是 log crate？

log 是 Rust 官方推荐的日志抽象接口，它本身不负责实际的日志输出，而是定义了一套统一的日志宏（如 info!、warn!、error! 等）。你需要搭配一个具体的日志实现（logger backend），比如 env_logger、simple_logger 或 fern 等。

第一步：创建新项目

打开终端，运行以下命令创建一个新的 Rust 项目：

cargo new rust_log_democd rust_log_demo

第二步：添加依赖

编辑 Cargo.toml 文件，添加 log 和 env_logger 两个依赖：

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

这里我们使用 env_logger 作为日志的后端实现，它可以根据环境变量控制日志级别，非常适合开发和调试。

第三步：编写日志代码

打开 src/main.rs，写入以下代码：

use log::{info, warn, error, LevelFilter};fn main() {    // 初始化 env_logger，并设置最低日志级别为 Info    env_logger::builder()        .filter_level(LevelFilter::Info)        .init();    info!("程序启动成功！");    warn!("这是一个警告信息。");    error!("发生了一个错误！");    let x = 10;    let y = 0;    if y == 0 {        error!("除数不能为零！x={}, y={}", x, y);    } else {        info!("计算结果: {}", x / y);    }}

第四步：运行程序

在终端中执行：

cargo run

你将看到类似如下的输出：

[2024-06-01T10:00:00Z INFO  rust_log_demo] 程序启动成功！[2024-06-01T10:00:00Z WARN rust_log_demo] 这是一个警告信息。[2024-06-01T10:00:00Z ERROR rust_log_demo] 发生了一个错误！[2024-06-01T10:00:00Z ERROR rust_log_demo] 除数不能为零！x=10, y=0

高级技巧：通过环境变量控制日志级别

你也可以不硬编码日志级别，而是通过环境变量动态控制。修改 main.rs 中的初始化部分：

env_logger::init();

然后在运行程序前设置环境变量：

# Linux/macOSRUST_LOG=info cargo run# Windows (PowerShell)$env:RUST_LOG="info"; cargo run

这样你就可以灵活地在不同环境下开启不同级别的日志，比如生产环境只记录 error，而开发环境记录 debug 以上。

总结

通过本教程，你已经掌握了如何在 Rust 项目中使用 log crate 进行日志记录。记住：log 提供接口，env_logger（或其他 logger）提供实现。这种设计使得你的代码与具体日志实现解耦，便于后期替换或升级。

无论你是学习 Rust logging 的新手，还是想优化现有项目的日志系统，这套方法都值得你掌握。赶快动手试试吧！

关键词回顾：Rust日志库、log crate、Rust logging、Rust教程