Windows平台下需用SetUnhandledExceptionFilter在main开头注册SEH异常回调，再于回调中调用MiniDumpWriteDump生成dump；必须传入有效文件句柄、正确MINIDUMP_TYPE（如MiniDumpWithThreadInfo）、匹配PDB，并避免在回调中调用不安全函数。
Windows平台下用SetUnhandledExceptionFilter捕获崩溃
Minidump不是C++标准能力，而是Windows特有的调试信息快照机制。程序崩溃（如访问空指针、栈溢出、非法指令）触发未处理异常时，SetUnhandledExceptionFilter能让你插手并生成dump。它必须在主线程早期调用（比如main开头或WinMain第一行），晚了可能错过某些异常（如DLL加载期崩溃）。
常见错误是把它放在某个子函数里，或者只在某个线程调用——它只对当前线程生效，而主线程的未处理异常才真正决定进程生死。多线程程序仍需在主线程注册，其他线程崩溃会沿调用栈向上传播，最终落到主线程过滤器上（前提是没被中间层吞掉）。
用MiniDumpWriteDump写入dump文件要传对三个关键句柄
生成dump的核心是MiniDumpWriteDump，但它不接受文件路径，只接受一个HANDLE（即已打开的文件句柄）。容易踩的坑包括：
- 直接传
CreateFile(L"crash.dmp", ...)返回值，但忘了检查是否为INVALID_HANDLE_VALUE（权限不足、路径不存在、杀软拦截都可能导致失败） - 用
fopen+_get_osfhandle绕过——可行但多此一举，且容易因_O_NOINHERIT标志缺失导致子进程继承句柄 - 忽略
MINIDUMP_TYPE参数：只传MiniDumpNormal可能拿不到堆内存或线程上下文；调试需要堆栈和模块信息时，至少加MiniDumpWithFullMemoryInfo | MiniDumpWithThreadInfo | MiniDumpWithHandleData
示例关键片段：
HANDLE hFile = CreateFile(L"minidump.dmp", GENERIC_WRITE, 0, nullptr,
CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL, nullptr);
if (hFile != INVALID_HANDLE_VALUE) {
MiniDumpWriteDump(GetCurrentProcess(), GetCurrentProcessId(),
hFile, MiniDumpWithFullMemoryInfo | MiniDumpWithThreadInfo,
&excParam->ExceptionPointers, nullptr, nullptr);
CloseHandle(hFile);
}
结构化异常（SEH）和C++异常混用时SetUnhandledExceptionFilter不生效
如果代码里用了__try/__except，或第三方库（如某些图形驱动、音频SDK）内部吞掉了异常，SetUnhandledExceptionFilter就收不到通知。更隐蔽的是：C++ throw抛出的异常默认不会触发它，除非你用_set_se_translator把SEH翻译成C++异常，再反向桥接——但这样反而掩盖了原始崩溃点。
真实场景中建议：
- 关闭编译器选项
/EHsc（或改用/EHa）让C++异常也能被SEH机制捕获——但会增大二进制体积，且可能干扰正常异常处理逻辑 - 优先用
SetUnhandledExceptionFilter抓原生崩溃，另起线程用std::set_terminate捕获未处理的C++异常，两者并存，日志里打上来源标记 - 避免在过滤器回调里调用
malloc、std::string构造或任何可能再次触发异常的代码——此时堆可能已损坏，只用栈变量和Windows API
64位程序要注意CONTEXT结构大小和符号路径
32位和64位的CONTEXT结构体大小不同，MiniDumpWriteDump内部会根据当前进程架构自动适配，但如果你手动解析dump，就得对应加载dbghelp.dll的正确版本（x64程序不能用x86的dbghelp）。更实际的问题是符号：没有PDB文件，Windbg只能看到???和地址。别依赖相对路径——程序可能从任意位置启动，应硬编码或通过注册表/配置文件指定PDB搜索路径，例如调用SymInitialize时传L".;C:\symbols"。
另外，MiniDumpWriteDump本身不压缩，一个完整内存dump可能几百MB。线上环境建议限制类型：MiniDumpNormal | MiniDumpWithDataSegs | MiniDumpWithIndirectlyReferencedMemory通常够定位绝大多数问题，又不至于写满磁盘。
真正难的不是写dump，是确保它在客户机器上能被你自己的符号和工具链正确读取——路径、架构、PDB时间戳、VS版本，漏一环就白忙活。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
