You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

VC++ 2019新建项目XDCMake未执行 无法生成最终XML文档问题

问题根因

从构建日志可定位到两个核心异常:

  1. ResolvedXDCMake 目标判定条件中 $(_ClCompileGenerateXMLDocumentationFiles) 属性值为空,触发跳过逻辑,项目关联的XDC文件收集流程未执行
  2. 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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.06 10:21:01