Delphi 11.2 IDE与命令行MSBuild版本不一致致构建失败求助

问题背景 #

Delphi 11.2项目在IDE中构建正常，但通过Rad Studio命令提示符执行msbuild Project1.dproj时失败。核心差异在于：

• IDE使用MSBuild .NET Framework v4.0，支持Exec任务的ConsoleToMSBuild参数
• 命令行默认使用MSBuild .NET Framework v2.0，该版本Exec任务无此参数，导致构建报错

用户需求：通过Exec获取Git提交哈希用于版本信息，需支持CI服务器自动构建，且不想依赖手动添加/tv:4.0命令行参数或修改易被Delphi自动覆盖的.dproj文件。

可复现步骤 #

• 创建新的Delphi 11.2 Windows VCL项目，保留空窗体
• 右键项目视图 → 「Add New->Other」，搜索「Target」并添加「MSBuild Targets File」，右键启用该文件
• 编辑Targets文件内容如下：

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003" InitialTargets="MyNewTarget">

  <Target Name="MyNewTarget" BeforeTargets="Build;Make">

    <Message Text="MSBuildToolsPath: $(MSBuildToolsPath)" Importance="High"/>
    <Message Text="MSBuildToolsVersion: $(MSBuildToolsVersion)" Importance="High"/>
    <Message Text="MSBuildBinPath: $(MSBuildBinPath)" Importance="High"/>

    <Exec Command="echo MyOutput" ConsoleToMSBuild="true" StandardOutputImportance="low">
      <Output TaskParameter="ConsoleOutput" PropertyName="MyProperty"/>
    </Exec>

    <Message Text="MyProperty: $(MyProperty)" Importance="High"/>

  </Target>

</Project>

• IDE构建成功，命令行构建因ConsoleToMSBuild参数报错。

解决方案 #

方案1：兼容MSBuild 2.0的命令输出获取方式 #

放弃ConsoleToMSBuild参数，改用「命令输出到临时文件→读取文件内容→删除临时文件」的兼容方式，适配所有MSBuild版本：

修改Targets文件中的Exec及后续逻辑：

<Target Name="MyNewTarget" BeforeTargets="Build;Make">
  <!-- 保留原版本信息输出 -->
  <Message Text="MSBuildToolsPath: $(MSBuildToolsPath)" Importance="High"/>
  <Message Text="MSBuildToolsVersion: $(MSBuildToolsVersion)" Importance="High"/>
  <Message Text="MSBuildBinPath: $(MSBuildBinPath)" Importance="High"/>

  <!-- 替换原Exec任务为兼容逻辑 -->
  <Exec Command="git rev-parse --short HEAD > git_hash.txt" ConsoleToMSBuild="false" />
  <ReadLinesFromFile File="git_hash.txt">
    <Output TaskParameter="Lines" PropertyName="GitCommitHash" />
  </ReadLinesFromFile>
  <Delete Files="git_hash.txt" Condition="Exists('git_hash.txt')" />

  <Message Text="GitCommitHash: $(GitCommitHash)" Importance="High"/>
</Target>

优势：完全兼容MSBuild 2.0/4.0，无需依赖环境配置，适合CI环境自动化构建。

方案2：在自定义Targets中强制指定MSBuild 4.0工具集 #

在自定义Targets文件的根Project节点添加ToolsVersion="4.0"，强制使用高版本MSBuild工具集：

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003" 
         InitialTargets="MyNewTarget"
         ToolsVersion="4.0">

  <Target Name="MyNewTarget" BeforeTargets="Build;Make">
    <!-- 保留原逻辑，包括ConsoleToMSBuild参数 -->
    <Message Text="MSBuildToolsPath: $(MSBuildToolsPath)" Importance="High"/>
    <Message Text="MSBuildToolsVersion: $(MSBuildToolsVersion)" Importance="High"/>
    <Message Text="MSBuildBinPath: $(MSBuildBinPath)" Importance="High"/>

    <Exec Command="git rev-parse --short HEAD" ConsoleToMSBuild="true" StandardOutputImportance="low">
      <Output TaskParameter="ConsoleOutput" PropertyName="GitCommitHash"/>
    </Exec>

    <Message Text="GitCommitHash: $(GitCommitHash)" Importance="High"/>
  </Target>

</Project>

优势：无需修改原有任务逻辑，保留ConsoleToMSBuild的简洁性；Delphi 11.2环境默认包含MSBuild 4.0，无需额外配置。

方案3：全局设置命令行环境的MSBuild版本 #

修改Rad Studio命令提示符的快捷方式，或在CI构建脚本开头添加环境变量，强制默认使用MSBuild 4.0：

1. 本地命令提示符：右键快捷方式 → 属性 → 目标，修改为：

   set MSBuildToolsVersion=4.0 && "C:\Program Files (x86)\Embarcadero\Studio\22.0\bin\rsvars.bat" && cmd
   

2. CI构建脚本：在执行msbuild前添加：

   set MSBuildToolsVersion=4.0
   

优势：一劳永逸，所有命令行构建均默认使用高版本MSBuild，无需修改项目文件。

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