dbghelp加载符号需手动指定pdb和原始exe路径，确保时间戳与校验和匹配；调用syminitialize时传入分号分隔的符号路径，symloadmodule64加载主模块须用原始exe全路径；启用symopt_load_lines等选项，配合stackwalk64、symfromaddr、symgetlinefromaddr64完成行号解析；注意unicode路径、缓冲区大小、线程安全及架构一致性。
DbgHelp 加载符号前必须手动指定符号路径和可执行路径
默认情况下 MiniDumpReadDumpStream 或 SymInitialize 完全不会自动查找 PDB 或 EXE，离线环境更不会连微软符号服务器。你得自己告诉 DbgHelp：PDB 在哪、主模块的原始 EXE 文件在哪（用于匹配时间戳和校验和）。
关键操作是调用 SymInitialize 时传入合法的符号搜索路径字符串，格式为 "C:\symbols;C:\myapp\pdb"，多个路径用分号分隔；同时确保 SymLoadModule64 加载主模块时传入的是原始构建时的 .exe 文件路径（不是 dump 文件路径），否则 SymFromAddr 和 StackWalk64 无法关联源码行号。
- 符号路径中不要包含通配符或环境变量，DbgHelp 不展开
%ProgramFiles%这类东西 - 如果 PDB 和 EXE 不在同目录，必须显式用
SymLoadModule64加载 EXE 模块，并传入其完整磁盘路径 - 调用
SymSetOptions开启SYMOPT_LOAD_LINES | SYMOPT_FAIL_CRITICAL_ERRORS，否则行号信息静默丢失
解析堆栈时必须用 StackWalk64 + SymFromAddr + SymGetLineFromAddr64 组合
仅靠 MiniDumpReadDumpStream 读出的 MINIDUMP_THREAD_LIST 或 MINIDUMP_EXCEPTION_STREAM 只有原始 RIP/RSP 值，没有函数名和行号。真正还原需要走完整的符号解析链：
先用 StackWalk64 遍历每个线程的调用帧，对每个 Frame.AddrPC.Offset 调用 SymFromAddr 获取函数名，再用 SymGetLineFromAddr64 查该地址对应的源文件与行号。缺任意一环都会退化成 0x7ff... 这样的地址。
通过 SSH 隧道从 Android 设备在互联网上对 Windows PC 实现完整远程控制的设置与使用指南，适用于远程桌面访问、安全 RDP 等。
-
StackWalk64的MachineType必须与 dump 文件架构严格一致（IMAGE_FILE_MACHINE_AMD64或IMAGE_FILE_MACHINE_I386），错一个就返回 false - 每次调用
SymFromAddr前要确认该地址所属模块已通过SymLoadModule64加载，否则返回ERROR_INVALID_ADDRESS -
SymGetLineFromAddr64成功只表示 PDB 含行号信息，但返回的LineFileName是宽字符路径，且可能是相对路径（如src\main.cpp），需结合原始构建路径拼出绝对路径
离线符号必须匹配原始构建的 timestamp 和 size，否则 SymLoadModule64 失败
DbgHelp 校验 PDB 时不仅看 GUID，还会比对关联 EXE 文件头里的 TimeDateStamp 和 SizeOfImage 字段。如果 dump 来自某次 CI 构建的 app.exe，那你手头的 app.pdb 和 app.exe 必须是同一构建产物——哪怕只是重链接过一次，时间戳就变了，SymLoadModule64 就会静默失败，后续所有符号查询都返回空。
- 用
dumpbin /headers app.exe查看time date stamp和size of image，再用cvdump -a app.pdb（需 Windows SDK 工具）核对 PDB 中的Age和GUID是否匹配 - 常见坑：把 Release 版本的 EXE 和 Debug 版本的 PDB 配对，或用了不同编译器版本生成的产物
- 如果只有 PDB 没有原始 EXE，可以用
symchk /v /s . app.exe（即使 app.exe 不存在）来提取 PDB 内嵌的期望 EXE 时间戳，反向推导该找哪个 EXE
Unicode 路径和线程本地存储（TLS）导致的常见崩溃点
DbgHelp 函数多数是 ANSI/Unicode 混合接口，比如 SymInitializeA 和 SymInitializeW 行为不同；而 SymFromAddr 返回的 SYMBOL_INFO 中 Name 字段是窄字符，但 SymGetLineFromAddr64 返回的 LineFileName 是宽字符。混用或未正确分配缓冲区会触发访问冲突。
- 统一使用
SymInitializeW和宽字符路径，避免 ANSI 接口在非 Latin-1 路径下截断 -
SYMBOL_INFO结构体必须按文档要求用sizeof(SYMBOL_INFO) + sizeof(TCHAR) * MAX_SYM_NAME分配，不能只 mallocsizeof(SYMBOL_INFO) - DbgHelp 不是线程安全的，多线程并发解析多个 dump 时，必须对
SymInitialize/SymCleanup和所有Sym*调用加全局锁，或为每个线程单独初始化独立的符号句柄（调用SymInitialize时最后一个参数设为FALSE）
实际跑通的关键往往卡在 PDB/EXE 时间戳不匹配，或者忘了给 SymGetLineFromAddr64 传足够大的 DWORD64 * 缓冲区去接行号——这个参数填错会导致函数直接 crash，而不是返回错误码。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
