使用Directory.Build.targets设置TargetFramework/TargetFrameworkVersion遇构建错误求解

需求与背景 #

需要统一将解决方案中所有项目的.NET框架版本从4.8.1降级到4.8：

• SDK风格项目修改TargetFramework属性
• 传统.NET Framework项目修改TargetFrameworkVersion属性
  已知Directory.Build.props用于添加未定义的属性（项目文件加载前导入），Directory.Build.targets用于覆盖已定义的属性（项目文件加载后导入），因此选择后者实现版本降级。

现有配置 #

解决方案根目录下的Directory.Build.targets内容：

<Project>
  <PropertyGroup Condition="'$(TargetFramework.Contains(net481))' == 'true'">
    <TargetFramework>net48</TargetFramework>
  </PropertyGroup>
  <PropertyGroup Condition="'$(TargetFrameworkVersion.Contains(v4.8.1))' == 'true'">
    <TargetFrameworkVersion>v4.8</TargetFrameworkVersion>
  </PropertyGroup>
</Project>

构建错误信息 #

Severity    Code    Description Project File    Line    Suppression State
Error       Project '..\GenericName.csproj' targets 'net48'. It cannot be referenced by a project that targets '.NETFramework,Version=v4.8'.    GenericName C:\Program Files\Microsoft Visual Studio\2022\Professional\MSBuild\Current\Bin\amd64\Microsoft.Common.CurrentVersion.targets    1830    

当前所有项目均在文件中定义了4.8.1版本，SDK风格项目可正常降级，但传统项目出现上述错误，怀疑是传统项目的条件判断或属性设置存在问题。

解决方案 #

问题根源 #

1. 条件判断不严谨：原配置中使用Contains方法判断版本，若属性未定义（如传统项目默认无TargetFramework）会导致判断逻辑异常，且可能误匹配相似版本字符串。
2. 框架标识不一致：SDK风格项目使用net48作为框架标识，传统项目仅设置TargetFrameworkVersion=v4.8时，MSBuild会将其识别为.NETFramework,Version=v4.8，与SDK项目的标识不统一，引发引用兼容性错误。

修改后的Directory.Build.targets #

<Project>
  <!-- 处理SDK风格项目：精准匹配net481版本并降级 -->
  <PropertyGroup Condition="$(TargetFramework) == 'net481'">
    <TargetFramework>net48</TargetFramework>
  </PropertyGroup>

  <!-- 处理传统.NET Framework项目：精准匹配v4.8.1版本并降级，同时同步框架标识 -->
  <PropertyGroup Condition="$(TargetFrameworkVersion) == 'v4.8.1'">
    <TargetFrameworkVersion>v4.8</TargetFrameworkVersion>
    <!-- 新增TargetFramework属性，与SDK项目统一框架标识 -->
    <TargetFramework>net48</TargetFramework>
  </PropertyGroup>
</Project>

说明 #

• 精准版本判断：直接使用==判断属性值，避免Contains带来的误判或未定义属性的异常。
• 统一框架标识：给传统项目添加TargetFramework=net48属性，让MSBuild将其与SDK项目识别为同一目标框架，解决引用冲突问题。
• 导入时机验证：Directory.Build.targets在项目文件加载后导入，确保能覆盖项目中已定义的框架版本属性。

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