MsBuild正则提取DefineConstants中自定义变量为空异常排查

问题根因 #

MSBuild 对不在 Target 内部的静态 PropertyGroup 会严格按照代码书写顺序从上到下逐行求值，你现有代码的声明顺序直接导致了变量赋值失效：

1. 首先计算 N1 配置的 DefineConstants 赋值
2. 紧接着就执行正则提取逻辑计算 MySite 变量
3. 之后才声明 N2 配置的 DefineConstants 赋值
   当你选择 N2 配置构建时，执行到正则提取步骤时，DefineConstants 还没有被赋值为包含 SITE_N2 的值，因此正则匹配结果为空，MySite 始终无法拿到正确值。后续依赖 MySite 判条的 SharedResPath 自然也无法赋值。
   另外你代码片段中存在标签不匹配的笔误：<SharedResPath> 的闭合标签写成了 </PathPilotageKX>，需要修正。

解决方案 #

方案1：调整静态属性声明顺序 #

把所有配置相关的 DefineConstants 声明全部放到变量提取逻辑之前，保证计算 MySite 时已经拿到当前配置的完整常量定义：

<!-- 第一步：先声明所有配置的常量定义 -->
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'N1|AnyCPU' ">
  <DefineConstants>TRACE;DEBUG;SITE_N1</DefineConstants>
</PropertyGroup>
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'N2|AnyCPU' ">
  <DefineConstants>TRACE;DEBUG;SITE_N2</DefineConstants>
</PropertyGroup>

<!-- 第二步：提取站点变量 -->
<PropertyGroup Label="Site Extractor">
  <MySite>$([System.Text.RegularExpressions.Regex]::Match($(DefineConstants), '(?<=(?:^|;)SITE_)([^;$]+)(?=;|$)'))</MySite>
</PropertyGroup>

<!-- 第三步：按站点赋值专属属性 -->
<PropertyGroup Label="N1 Specifics" Condition="$(MySite) == 'N1'">
  <SharedResPath>..\..\Resources\N1.1</SharedResPath>
</PropertyGroup>
<PropertyGroup Label="N2 Specifics" Condition="$(MySite) == 'N2'">
  <SharedResPath>..\..\Resources\N2.0</SharedResPath>
</PropertyGroup>

<!-- 验证任务保持不变 -->
<Target Name="My Validations" BeforeTargets="BeforeBuild">
  <Message Text="DefinedConstants: [$(DefineConstants)]" />
  <Message Text="Site: [$(MySite)]" />
  <Message Text="Shared Res Path: [$(SharedResPath)]" />
  <Message Text="Configuration: $(Configuration)" />
  <Error Text="Site code (SITE_$(MySite)) is not supported by csproj (MSBuild)." Condition="$(SharedResPath) == ''" />
</Target>

方案2：将变量计算移入Target（更稳妥） #

静态属性求值容易受顺序影响，更推荐把动态计算逻辑放到构建阶段的Target中执行，此时所有静态配置已经全部加载完成，完全不受声明顺序影响：

<!-- 配置声明顺序无需调整 -->
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'N1|AnyCPU' ">
  <DefineConstants>TRACE;DEBUG;SITE_N1</DefineConstants>
</PropertyGroup>
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'N2|AnyCPU' ">
  <DefineConstants>TRACE;DEBUG;SITE_N2</DefineConstants>
</PropertyGroup>

<Target Name="InitSiteVars" BeforeTargets="BeforeBuild">
  <!-- 构建阶段计算变量，此时DefineConstants已经是当前配置的最终值 -->
  <PropertyGroup>
    <MySite>$([System.Text.RegularExpressions.Regex]::Match($(DefineConstants), '(?<=(?:^|;)SITE_)([^;$]+)(?=;|$)'))</MySite>
    <SharedResPath Condition="$(MySite) == 'N1'">..\..\Resources\N1.1</SharedResPath>
    <SharedResPath Condition="$(MySite) == 'N2'">..\..\Resources\N2.0</SharedResPath>
  </PropertyGroup>
  
  <!-- 验证逻辑直接放这里即可 -->
  <Message Text="DefinedConstants: [$(DefineConstants)]" />
  <Message Text="Site: [$(MySite)]" />
  <Message Text="Shared Res Path: [$(SharedResPath)]" />
  <Message Text="Configuration: $(Configuration)" />
  <Error Text="Site code (SITE_$(MySite)) is not supported by csproj (MSBuild)." Condition="$(SharedResPath) == ''" />
</Target>

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