MSBuild如何检测当前构建评估是否处于<MSBuild>任务内部

嵌套构建上下文判断逻辑（无需修改外部任务代码） #

MSBuild没有原生提供示例中AreWeInsideOfAnMsBuildTarget属性，可通过内置保留属性组合实现同等判断，兼容MSBuild 15.0（VS2017）及以上版本：

<PropertyGroup>
  <!-- 默认标记为顶层构建场景 -->
  <IsInNestedMSBuildCall>false</IsInNestedMSBuildCall>
  <!-- MSBuild 16.0（VS2019）及以上版本，引擎在<MSBuild>任务创建子构建上下文时会自动注入MSBuildIsNested=true属性 -->
  <IsInNestedMSBuildCall Condition="'$(MSBuildIsNested)' == 'true'">true</IsInNestedMSBuildCall>
  <!-- 兼容旧版本：<MSBuild>任务宿主上下文会自动携带MSBuildTaskHost属性 -->
  <IsInNestedMSBuildCall Condition="'$(IsInNestedMSBuildCall)' != 'true' and '$(MSBuildTaskHost)' != ''">true</IsInNestedMSBuildCall>
</PropertyGroup>

上述判断逻辑不需要外部调用方做任何修改，MSBuildIsNested属性由引擎内核注入，不存在被外部任务篡改或遗漏传递的问题。

判断逻辑生效后，即可实现预期的属性条件赋值：

<PropertyGroup>
  <MyProperty>Value if called from "top level" build</MyProperty>
  <MyProperty Condition="'$(IsInNestedMSBuildCall)' == 'true'">Value if called from &lt;MSBuild&gt;</MyProperty>
</PropertyGroup>

Target重复执行问题修复 #

自定义Target执行3次的根因是任务传入不同Properties参数时，会创建独立的项目评估上下文，每个上下文维护独立的Target执行缓存，默认的已执行跳过逻辑无法跨上下文生效。可根据需求选择以下方案修复：

方案1：全局标记去重（推荐） #

不依赖上下文判断，通过和项目绑定的临时文件做全局执行标记，保证整个构建流程中Target逻辑仅执行一次，兼容所有嵌套场景：

<Target Name="YourCustomTarget" BeforeTargets="Build">
  <PropertyGroup>
    <!-- 生成和当前项目路径绑定的唯一标记文件，存放在系统临时目录避免不同输出目录的上下文冲突 -->
    <_CustomTargetMarker>$(Temp)\CustomTargetRan_$([System.IO.Path]::GetFileNameWithoutExtension($(MSBuildProjectFullPath))).tmp</_CustomTargetMarker>
  </PropertyGroup>

  <!-- 标记存在则直接跳过执行 -->
  <Message Condition="Exists('$(_CustomTargetMarker)')" Text="跳过已执行的自定义Target" Importance="low"/>
  <Return Condition="Exists('$(_CustomTargetMarker)')"/>

  <!-- 以下为Target实际需要执行的逻辑 -->
  <Message Text="执行自定义Target核心逻辑" Importance="high"/>

  <!-- 执行完成后写入标记 -->
  <WriteLinesToFile File="$(_CustomTargetMarker)" Lines="Executed at $([System.DateTime]::UtcNow.Ticks)" Overwrite="true"/>
</Target>

<!-- 构建结束后清理标记，避免下次构建误判 -->
<Target Name="CleanCustomTargetMarker" AfterTargets="Build;Rebuild">
  <Delete Files="$(Temp)\CustomTargetRan_$([System.IO.Path]::GetFileNameWithoutExtension($(MSBuildProjectFullPath))).tmp" Condition="Exists('$(Temp)\CustomTargetRan_$([System.IO.Path]::GetFileNameWithoutExtension($(MSBuildProjectFullPath))).tmp')"/>
</Target>

方案2：基于上下文的条件执行 #

如果需要严格区分顶层/嵌套场景执行不同逻辑，可直接使用前面定义的IsInNestedMSBuildCall属性给Target加执行条件：

<!-- 仅顶层构建时执行该Target，所有<MSBuild>嵌套调用场景直接跳过 -->
<Target Name="YourCustomTarget" BeforeTargets="Build" Condition="'$(IsInNestedMSBuildCall)' != 'true'">
  <Message Text="仅顶层构建执行自定义逻辑" Importance="high"/>
  <!-- 自定义逻辑内容 -->
</Target>

注意：如果嵌套调用是项目引用构建、多框架打包等正常流程，不建议直接跳过嵌套场景的Target执行，否则可能导致构建产物缺失。优先选择方案1的全局去重方案，保证逻辑执行一次的同时不影响正常构建流程。

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