lld-link 默认不生成 pdb,必须显式启用 /debug 开关;它会强制增量链接、禁用 /opt:ref/icf,并从 .obj 提取调试信息生成 app.pdb 且嵌入路径。

lld-link 默认不生成 PDB,必须显式启用
lld-link 本身不会自动生成 PDB 文件,哪怕你用 clang-cl 编译时加了 /Zi,只要链接时不告诉 lld-link 要写调试信息,最终的 .exe 或 .dll 就没有嵌入 PDB 路径,调试器也找不到符号。这不是 bug,是设计使然:PDB 生成是链接器职责,但默认关闭。
/DEBUG 是关键开关,但行为和 link.exe 不完全一致
在 lld-link 中启用 PDB 输出,必须传 /DEBUG(注意大小写,lld-link 区分大小写,/debug 无效)。它会做三件事:
- 强制启用增量链接(
/INCREMENTAL),所以不能和/LTCG同时用 - 禁用默认的优化选项:
/OPT:REF和/OPT:ICF会被关掉,如需保留,得手动加回去 - 从
.obj中提取调试信息,合并进新 PDB,并把 PDB 路径写入输出二进制
示例命令:
lld-link /DEBUG /OUT:app.exe main.obj util.obj
执行后会在当前目录生成 app.pdb,且 app.exe 内部嵌入了该路径。
常见失败原因:/Zi 编译 + /DEBUG 链接,但 PDB 还是没出来
这种情况通常卡在以下环节:
-
.obj文件里根本没调试信息——确认编译时用了/Zi(不是/Z7,后者把调试信息塞进 .obj 本体,lld-link 不支持) - 目标平台不匹配:lld-link 的 COFF 端口支持 PDB,但如果你误用了 ELF 模式(比如用
ld.lld替代lld-link),PDB 完全不会被处理 - 路径权限问题:lld-link 默认把 PDB 写在输出目录,若该目录只读或路径含中文/空格,可能静默失败(无错误提示)
- 用了
/PDBSTRIPPED却没指定文件名,导致 PDB 生成逻辑跳过
进阶控制:/PDB 和 /PDBSTRIPPED 的实际效果
想改默认 PDB 名或生成剥离版,这两个参数必须配合 /DEBUG 使用:
-
/PDB:myapp.pdb—— 指定 PDB 文件名和路径,同时更新二进制中嵌入的路径 -
/PDBSTRIPPED:myapp_stripped.pdb—— 生成两个 PDB:myapp.pdb(完整)和myapp_stripped.pdb(仅公共符号 + FPO),二进制里嵌的是完整版路径
注意:/PDBSTRIPPED 不会替代主 PDB,只是多输出一个;调试时仍需主 PDB 才能看局部变量和源码行号。
PDB 生成依赖编译与链接两阶段严格对齐,缺一不可。最容易忽略的是:即使 clang-cl /Zi 成功,只要 lld-link 没带 /DEBUG,就等于没调试信息——二进制里连 PDB 路径都没有,调试器连找都懒得找。











