VC++ 2019新建项目XDCMake未执行 无法生成最终XML文档问题
问题根因
从构建日志可定位到两个核心异常:
ResolvedXDCMake目标判定条件中$(_ClCompileGenerateXMLDocumentationFiles)属性值为空,触发跳过逻辑,项目关联的XDC文件收集流程未执行ComputeCLCompileGeneratedXDCFiles目标中临时添加的XdcMake项被直接移除,最终@(XdcMake)项组为空,触发XdcMake目标的跳过条件,XML合并生成步骤直接终止
该问题属于VS2019新建C++项目的常见配置同步异常,即使单个源文件已生成XDC文件,全局的XDC收集属性也可能未被正确激活。
修复步骤
- 确认编译器文档生成配置全局生效
打开项目属性页,顶部选择「所有配置」「所有平台」,依次进入配置属性 > C/C++ > 输出文件,确认「生成XML文档文件」选项值为是(/doc),点击应用保存配置 - 确认XDCMake工具配置正常
进入配置属性 > XML文档生成工具 > 常规,确认「输出文件」路径已正确填写,「生成XML文档」选项为是 - 手动修正项目文件(前两步无效时使用)
右键项目选择「卸载项目」,再次右键选择「编辑.vcxproj」,在文件中添加如下配置:
保存后重新加载项目即可<!-- 全局属性配置,放在对应配置的PropertyGroup节点下 --> <ClCompileGenerateXMLDocumentationFiles>true</ClCompileGenerateXMLDocumentationFiles> <GenerateXMLDocumentationFiles>true</GenerateXMLDocumentationFiles> <!-- 编译器项配置,放在ItemDefinitionGroup节点下的ClCompile子节点中 --> <ClCompile> <GenerateXMLDocumentation>true</GenerateXMLDocumentation> </ClCompile> - 清理缓存后重建
删除项目中间目录、输出目录的所有文件,执行「重新生成解决方案」,避免增量构建缓存干扰配置生效
验证标准
构建完成后检查指定的输出路径下是否生成了对应的XML文档,若仍有问题可查看诊断构建日志,确认@(XdcMake)项组已包含所有生成的.xdc文件路径。
内容的提问来源于stack exchange,提问作者Slava
相关产品推荐
相关产品推荐

