如何在Rust的lib.rs中仅执行一次日志配置代码？

1. 正确使用std::sync::Once实现初始化 #

Rust不允许在函数外直接调用方法（顶级上下文仅支持静态变量声明、导入等操作），你需要把Once定义为静态全局变量，再在工具函数内部调用它的call_once方法，确保初始化逻辑只执行一次。示例代码如下：

use std::sync::Once;
use log::LevelFilter;
use env_logger::Builder;

// 定义全局唯一的Once实例
static LOG_INIT: Once = Once::new();

// 封装日志配置逻辑
fn init_logging() {
    Builder::new()
        .filter_level(LevelFilter::Info)
        .format_module_path(false)
        .init();
}

// 工具类函数示例
pub fn tool_function_a() {
    // 首次调用时执行日志配置，后续调用直接跳过
    LOG_INIT.call_once(|| init_logging());
    info!("工具函数A被调用");
}

pub fn tool_function_b() {
    LOG_INIT.call_once(|| init_logging());
    info!("工具函数B被调用");
}

不管哪个工具函数先被外部调用，init_logging只会执行一次，无需给每个函数添加额外参数。

2. 关于日志配置的"crate本地"误解 #

Rust的log生态是全局共享的，并非每个crate独立配置。库crate仅负责通过log宏输出日志，日志的输出格式、级别等配置通常由最终的二进制可执行文件（应用层）完成。如果你的工具crate必须自行处理日志配置，上面的Once方案已能满足需求，且不会干扰应用层的全局配置（若应用层未配置日志，工具crate的配置会生效）。

3. 简化重复代码的技巧 #

可以把初始化逻辑封装成私有宏，减少每个工具函数的重复代码：

#[macro_export]
macro_rules! ensure_log_init {
    () => {
        $crate::LOG_INIT.call_once(|| $crate::init_logging());
    };
}

// 工具函数中直接调用宏
pub fn tool_function_c() {
    ensure_log_init!();
    info!("工具函数C被调用");
}

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