CMake项目Release构建中PDB符号文件无法包含源索引问题排查

1. pdbstr.exe验证源索引的正确性判断 #

你用pdbstr.exe验证后无输出且ERRORLEVEL=1，这个结果是准确的——当前PDB确实没有包含源索引信息。不过要确认你用的命令是否标准：
正确的验证命令应该是：

pdbstr.exe -r -p:你的项目.pdb -s:srcsrv

如果命令里的PDB路径错误、PDB文件损坏，或者没有足够权限读取PDB，也会出现同样的错误码。可以先检查PDB文件是否能被dumpbin.exe /headers正常读取，排除文件本身的问题。

2. 设置/Zi和/DEBUG后仍无源码索引的原因 #

/Zi（生成完整调试信息）和/DEBUG（生成调试符号链接）只是让PDB包含函数、变量的调试符号，但源索引（Source Indexing）是需要额外步骤生成的，编译链接阶段不会自动添加。
常见的遗漏点：

• CMake默认不会配置源索引流程，需要手动添加自定义构建步骤，调用微软的Source Server工具（如srctool、pdbstr）来给PDB嵌入源索引信息
• 你可能只给Debug配置加了/Zi和/DEBUG，但崩溃报告对应的是Release版本——Release模式下需要显式开启/Zi（不要用/Zd，它只生成有限调试信息）和/DEBUG，同时确保优化选项（如/O2）不会完全抹除行号（/Zi和优化可以共存）
• 增量构建导致PDB没有被重新生成：尝试清理构建目录后重新全量构建，避免旧的无索引PDB被复用
• 构建脚本中存在剥离PDB调试信息的步骤：比如某些打包脚本会用pdbstrip之类的工具去掉冗余信息，导致源索引丢失

3. 其他未考虑的潜在问题 #

• 编译时源文件使用了相对路径：源索引需要编译时记录的源文件绝对路径才能正确定位，若CMake传递给编译器的是相对路径，后续无法生成有效索引
• 崩溃报告工具的限制：部分工具需要显式配置加载带有源索引的PDB，或者不支持解析Source Server格式的索引信息
• 权限问题：运行pdbstr.exe时需要有读写PDB文件的权限，若PDB被构建进程占用或当前用户无修改权限，会导致索引嵌入失败
• CMake生成器的差异：如果用MSBuild作为生成器，需要额外在CMake中设置<SourceIndex>true</SourceIndex>属性，确保MSBuild触发源索引流程；用Ninja则需要手动添加自定义命令调用源索引工具

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