C++没有现成@log装饰器，因其编译期不支持运行时函数对象替换和语言级装饰器语法；需用模板+可变参数+表达式包装模拟，核心是“装饰一次调用”而非修改原函数。
为什么 C++ 没有现成的 @log 装饰器
C++ 编译期不支持 Python 那种运行时函数对象替换，也没有语言级装饰器语法。所谓“日志装饰器”只能靠模板 + 可变参数 + 表达式包装模拟，本质是生成一个带日志逻辑的代理调用器，而非修改原函数行为。
直接套用 Python 思维会掉坑：比如试图用宏包裹函数定义、或幻想用 std::function 统一包装所有签名——前者破坏调试信息，后者丢失类型和 noexcept 语义，还可能引入额外拷贝开销。
用 auto_log 模板包装调用表达式最可靠
核心思路不是“装饰函数”，而是“装饰一次调用”：把 func(args...) 包进一个模板函数，让它先打参数、再执行、再打返回值。这样不侵入原函数，保留所有类型信息和优化机会。
-
auto_log必须是函数模板，接受任意可调用对象（函数指针、lambda、成员函数指针）和参数包 - 参数需完美转发：
std::forward<args>(args)...</args>，否则右值可能被意外转成左值 - 返回值类型用
decltype(auto)，才能正确推导void、引用、noexcept等细节 - 避免对
void函数调用std::cout —— 必须特化处理
template<typename F, typename... Args>
decltype(auto) auto_log(const char* func_name, F&& f, Args&&... args) {
std::cout << "CALL " << func_name << "(";
((std::cout << args << ", "), ...); // 折叠表达式打印参数
std::cout << ")\n";
<pre class="brush:php;toolbar:false;">if constexpr (std::is_same_v<decltype(f(std::forward<Args>(args)...)), void>) {
std::forward<F>(f)(std::forward<Args>(args)...);
std::cout << "RETURN void\n";
} else {
auto result = std::forward<F>(f)(std::forward<Args>(args)...);
std::cout << "RETURN " << result << "\n";
return result;
}}
立即学习“C++免费学习笔记（深入）”；
怎么处理成员函数和重载函数名
直接传 &MyClass::method 会编译失败——模板无法从成员函数指针自动推导类类型。必须显式绑定或用 lambda 封装。
- 对非静态成员函数，用
[&obj](auto&&... a) { return obj.method(std::forward<auto>(a)...); }</auto>包一层 - 函数名字符串不能靠
__FUNCTION__自动获取：模板实例化时它只是字面量，必须手动传，否则日志里全是auto_log - 重载函数（如多个
foo(int)和foo(double)）需用static_cast指定具体地址，例如static_cast<int>(&foo)</int> - 如果函数在头文件中内联定义，确保
auto_log调用点能看到完整声明，否则 SFINAE 推导失败
性能与调试符号的实际影响
这个方案生成的代码几乎等价于手写日志——编译器能内联掉整个 auto_log 调用，只要开启 -O2。但有两个真实代价：
- 每次调用都多一次
std::cout输出，哪怕你用std::ostringstream缓存，也比原函数多几条指令 - 调试时栈帧里会出现
auto_log层，掩盖原始调用位置；建议只在#ifdef DEBUG下启用 - 不能捕获异常：如果原函数抛异常，
auto_log中的RETURN日志不会打印。需要额外 try/catch 包裹，但会干扰异常传播语义
真正难搞的是函数对象内部有状态（比如绑定的 std::shared_ptr），此时日志里的参数打印可能触发隐式转换或临时对象构造，导致行为和不加日志时不一致——这种副作用必须亲自验证，没法靠模板自动规避。
