如何基于OutputDebugString实现任意类型可变参数调试输出

核心逻辑非常直接：先把任意类型的输入参数统一格式化为宽字符串，再把拼接完成的字符串传给OutputDebugString接口，就能输出到VS的Output调试窗口。下面给出两种常用实现，按需选择即可。

方案1：C++17 可变参数模板实现（类型安全，优先推荐） #

这种实现没有类型匹配风险，支持所有重载了宽字符流<<运算符的类型，包括基础数值类型、字符串、自定义结构体/类，编译器会在编译期做类型检查，不会出现printf风格的类型不匹配导致的内存错误。

#include <Windows.h>
#include <sstream>
#include <string>
#include <utility>

template<typename... Args>
void DebugLog(Args&&... args)
{
    std::wostringstream stream_builder;
    // 折叠表达式遍历所有参数，参数间自动加空格分隔
    ((stream_builder << std::forward<Args>(args) << L" "), ...);
    stream_builder << L"\n"; // 末尾自动加换行，和常规打印行为一致
    OutputDebugStringW(stream_builder.str().c_str());
}

调用示例：

int user_age = 26;
double test_score = 97.5;
const wchar_t* user_name = L"李四";
DebugLog(L"用户信息：", L"姓名=", user_name, L"年龄=", user_age, L"测试得分=", test_score);

如果要打印自定义类型，只需要给对应类型实现宽字符流的<<重载即可，不需要修改DebugLog本身的逻辑。

方案2：兼容旧标准的printf风格实现 #

如果项目使用C++11之前的老旧编译环境，不支持可变参数模板，可以用C风格可变参数实现，接口和wprintf完全一致，学习成本低。

#include <Windows.h>
#include <cstdarg>
#include <cstdio>

void DebugLogPrintf(const wchar_t* format_str, ...)
{
    wchar_t buffer[2048]; // 单条日志最大长度2047个宽字符，可按需调整
    va_list arg_list;
    va_start(arg_list, format_str);
    // 安全格式化字符串，超出长度自动截断
    _vsnwprintf_s(buffer, _countof(buffer), _TRUNCATE, format_str, arg_list);
    va_end(arg_list);
    OutputDebugStringW(buffer);
}

调用示例：

DebugLogPrintf(L"用户信息：姓名=%s 年龄=%d 测试得分=%.1f\n", L"李四", 26, 97.5);

注意：这个方案必须严格匹配格式化占位符和参数类型，比如宽字符串要用%s（宽字符模式下的占位符）、int用%d、double用%f，传错类型会导致内存越界或输出乱码。如果需要输出超长日志，可以先调用一次_vsnwprintf_s传入空指针拿到所需缓冲区长度，动态申请内存后再做格式化，避免截断。

注意事项 #

• 优先使用宽字符版本OutputDebugStringW：OutputDebugStringA是兼容层，内部会把窄字符串转成宽字符再调用W版，直接用宽字符可以避免中文等非ASCII字符输出乱码
• 该接口仅在进程绑定调试器时生效，没有挂调试器的情况下调用不会产生任何副作用，也不会报错
• 如果需要同时把日志输出到控制台、本地文件，只需要在格式化完成得到最终字符串后，额外加对应的输出逻辑即可

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