分级日志、日志切割、日志上报

在桌面应用中，日志是排查问题和监控运行状态的基础。Tauri 的 Rust 后端生态系统提供了成熟且灵活的日志方案，能轻松实现分级日志、文件切割和远程上报，而无需引入庞大框架。

分级日志

Rust 的 log 库定义了标准的日志级别：Error、Warn、Info、Debug、Trace，分别对应不同的严重程度。在代码中使用宏即可输出日志：

use log::{info, warn, error};

info!("用户点击保存按钮");
warn!("文件操作耗时超过 3 秒");
error!("读取配置文件失败: {}", e);

这些日志并不会自动输出，需要配合实现“门面”的具体后端。常用的有 env_logger（基于环境变量控制级别）和 tracing（支持异步、结构化日志）。对于生产级应用，推荐使用 tracing，它便于同时输出到控制台、文件以及上报通道。

配置方式极简：在 Tauri 的 main.rs 中初始化订阅者，例如：

tracing_subscriber::fmt()
    .with_env_filter("my_app=debug,tauri=info")
    .init();

之后，你可以在 Rust 代码和前端（通过 Tauri 命令）按级别输出日志。对于调试期，可以设置 RUST_LOG=debug 环境变量，让 Debug 及以下级别的日志全部打印；生产环境可调整为 info 及以上。

日志切割

长期运行的应用如果只写一个日志文件，很快就会变得臃肿、难以查阅。日志切割（Log Rotation）按时间或大小自动分割日志文件，并清理旧归档。

最常用的 Rust 库是 tracing-appender，它提供了滚动文件写入器：

use tracing_appender::rolling::{RollingFileAppender, Rotation};
use tracing_subscriber::fmt::writer::MakeWriterExt;

let file_appender = RollingFileAppender::new(
    Rotation::DAILY,          // 每天凌晨产生新文件
    "./logs",                 // 目录
    "my_app.log",            // 文件名前缀
);
let (non_blocking, _guard) = tracing_appender::non_blocking(file_appender);
tracing_subscriber::fmt()
    .with_writer(non_blocking.and(std::io::stdout)) // 同时输出到控制台
    .init();

设置 Rotation::DAILY 或 Rotation::HOURLY 可以让文件名自动带日期后缀，如 my_app.log.2025-03-27。如果想按大小切割，可以结合 rolling_file 的 max_file_size 参数（部分库支持）或使用 file-rotate 箱手动实现。清理旧日志可以指定保留天数，比如设为 7 天，超过的自动删除，避免磁盘填满。

日志上报

当应用运行在用户端，本机日志只能由用户提供，效率很低。日志上报（远程收集）能让你在问题发生第一时间就获取上下文。但必须注意隐私合规和用户授权：只上报必要的错误和关键事件，避免收集敏感信息，且在应用中提供开关。

实现方式很简单：自定义一个实现了 tracing_subscriber::Layer 的组件，或在关键错误处直接发送 HTTP 请求。一个轻量的上报函数示例：

use reqwest::Client;
use tracing::error;

async fn report_error(message: &str, ctx: &str) {
    let client = Client::new();
    let payload = serde_json::json!({
        "app_version": "1.0.0",
        "message": message,
        "context": ctx,
        "os": std::env::consts::OS,
    });
    if let Err(e) = client.post("https://your.server/api/logs")
        .json(&payload)
        .timeout(std::time::Duration::from_secs(3))
        .send()
        .await
    {
        eprintln!("上报失败: {}", e);
    }
}

配合 tracing 的 error! 宏和一个自定义 Layer，可以做到所有 Error 级别的日志自动异步上报，且不阻塞主线程。生产环境建议增加本地缓冲（如写入临时文件），在网络恢复时补传。

真实案例：一体化配置

下面给出一个整合上述三点的 Rust 启动代码片段，实用且真实：

fn init_logging() -> tracing_appender::non_blocking::WorkerGuard {
    let file_appender = RollingFileAppender::new(
        Rotation::DAILY,
        "./logs",
        "app.log",
    );
    let (non_blocking, guard) = tracing_appender::non_blocking(file_appender);

    let subscriber = tracing_subscriber::fmt()
        .with_env_filter("info,my_app=debug")
        .with_writer(non_blocking.and(std::io::stdout))
        .finish()
        .with(RemoteReportLayer); // 自定义上报层

    tracing::subscriber::set_global_default(subscriber)
        .expect("全局日志收集器设置失败");

    guard // 需要持有此 guard，否则日志会丢失
}

在主函数中调用 let _guard = init_logging();，程序结束时 guard 被 drop，缓冲区里的日志会完整写入文件。

这套方案完全基于 Rust 生态，体积增加极小（几个依赖加起来约 80KB），完全符合 Tauri 轻量的理念。你不需要依赖外部日志服务，就可以用几十行代码构建出生产可用的分级、切割、上报日志系统。