如何在Visual Studio 2022中检测C代码的未调用函数（死代码）

一、确保PDB包含未调用函数的信息 #

VS默认的编译/链接优化会移除未被引用的函数，导致PDB中丢失这些函数的元数据，进而让OpenCppCoverage无法识别。需要调整以下选项：

• 编译器选项：
  • 移除/Gy选项（该选项启用函数级链接，会让链接器仅保留被引用的函数）；若必须使用/Gy，需配合后续链接器选项。
  • 添加/Ob0，禁用函数内联优化，避免未调用的静态函数被编译器直接剔除。
  • 确保启用/Zi（生成完整调试PDB），不要使用/ZI（增量PDB可能丢失部分函数信息）。
• 链接器选项：
  • 添加/OPT:NOREF，强制链接器保留所有函数，即使未被引用。
  • 添加/OPT:NOICF，禁止链接器合并重复的未调用函数，确保每个函数的信息都能保留在PDB中。

二、启用未用函数的编译/链接警告 #

通过VS的警告机制直接定位未调用函数：

• 静态未用函数：
  • 添加编译器选项/w14505，将C4505警告（未引用的静态函数会被编译器移除）提升为一级警告，编译时会直接提示这类函数。
  • 也可直接启用/W4（最高警告级别），但会触发更多其他警告，需按需筛选处理。
• 公共未用函数：
  • 添加链接器选项/warn:4217，启用LNK4217警告（被导出但未被引用的公共函数）；若需要强制修正，可搭配/WX将链接警告视为错误。

三、调整OpenCppCoverage配置 #

确保工具能正确读取PDB中的完整函数信息：

• 运行OpenCppCoverage时添加--cover_children参数，确保捕获所有子进程的代码覆盖（若项目涉及多进程）。
• 用--pdb_path参数指定生成的PDB文件路径，避免工具加载旧的、不完整的PDB。
• 添加--exclude_modules排除无关第三方库模块，减少结果干扰。

四、VS自带工具辅助检测死代码 #

除OpenCppCoverage外，VS本身也有原生工具可检测死代码：

• 代码分析：右键项目→分析→运行代码分析，启用“未使用的函数”规则（位于“性能”类别），会扫描并报告未被调用的函数。
• Clang-Tidy：在项目属性中启用Clang-Tidy，开启unused-function检查器，可精准检测未使用的静态函数和未导出的公共函数。

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