如何在Rust中编写支持format!风格参数的日志函数？

你遇到的问题本质是普通Rust函数无法像format!那样支持可变参数的格式化逻辑，最直接且简单的解决方案是写一个宏——不用照搬标准库format!的复杂实现，我们可以直接复用它的能力来封装你的日志逻辑。

方案1：封装现有log函数的宏 #

如果你想保留原有的log函数（比如里面有fancy_output的自定义逻辑），可以写一个简单的宏来自动生成format!调用：

// 你的原有日志函数
fn log(msg: &str) {
    // fancy_output 自定义逻辑
    println!("{}", msg);
}

// 新增的日志宏
macro_rules! log {
    ($fmt:expr, $($args:tt)*) => {
        // 自动用format!格式化参数，再传给原log函数
        log(&format!($fmt, $($args)*));
    };
}

调用方式和你期望的几乎一致（注意Rust宏必须加!）：

let x = 5;
log!("{:?}", x); // 支持Debug格式化
let name = "Alice";
log!("Hello, {}", name); // 也支持Display格式化

方案2：整合逻辑的宏（更简洁） #

如果不需要保留独立的log函数，可以把所有逻辑直接放进宏里，省去一层函数调用：

macro_rules! log {
    ($fmt:expr, $($args:tt)*) => {
        // 这里放你的fancy_output逻辑
        println!("{}", format!($fmt, $($args)*));
    };
}

调用方式完全相同：

#[derive(Debug)]
struct User { id: u32, name: &'static str }

let user = User { id: 123, name: "Bob" };
log!("用户信息：{:#?}", user); // 支持带缩进的Debug格式化

为什么不用函数？ #

Rust的普通函数不支持可变数量的类型安全参数，虽然可以用&[dyn Display]这类动态分发的方式，但会丢失编译期类型检查，而且写法反而更繁琐。而宏是编译期展开的，完全复用format!的类型安全特性，同时彻底消除重复的format!代码。

这个宏的实现非常轻量化：

• $fmt:expr匹配格式化字符串表达式
• $($args:tt)*匹配任意数量、任意类型的后续参数
• 展开后直接调用format!完成格式化，再传递给日志逻辑

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