如何对兼容至.NET 2.0的多目标项目进行单元测试

针对你的多目标兼容性类库测试需求，以下是无需拆分多个项目、适配从.NET 2.0到8.0全版本的稳定测试方案：

1. 测试项目MSBuild配置（核心） #

采用SDK风格项目，通过条件引用适配不同框架的测试框架，避免版本冲突。以下是完整的.csproj示例：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFrameworks>net8.0;net7.0;net6.0;net5.0;netcoreapp3.1;netcoreapp3.0;netcoreapp2.2;netcoreapp2.1;netcoreapp2.0;netcoreapp1.1;netcoreapp1.0;net481;net48;net472;net471;net47;net462;net461;net46;net452;net451;net45;net403;net40;net35;net30;net20</TargetFrameworks>
    <!-- 禁用并行测试，避免老框架资源竞争导致不稳定 -->
    <ParallelizeTestCollections>false</ParallelizeTestCollections>
    <IsPackable>false</IsPackable>
  </PropertyGroup>

  <!-- 引用你的兼容性类库 -->
  <ItemGroup>
    <ProjectReference Include="..\YourLibrary\YourLibrary.csproj" />
  </ItemGroup>

  <!-- .NET Framework 4.0及以下：使用MSTest v1 -->
  <ItemGroup Condition=" '$(TargetFramework)' == 'net40' Or '$(TargetFramework)' == 'net35' Or '$(TargetFramework)' == 'net30' Or '$(TargetFramework)' == 'net20' ">
    <PackageReference Include="Microsoft.VisualStudio.QualityTools.UnitTestFramework" Version="10.1.0" />
  </ItemGroup>

  <!-- .NET 4.5+及所有.NET Core/.NET 5+：使用MSTest v2 -->
  <ItemGroup Condition=" '$(TargetFramework)' != 'net40' And '$(TargetFramework)' != 'net35' And '$(TargetFramework)' != 'net30' And '$(TargetFramework)' != 'net20' ">
    <PackageReference Include="MSTest.TestFramework" Version="3.1.1" />
    <PackageReference Include="MSTest.TestAdapter" Version="3.1.1" />
    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />
  </ItemGroup>
</Project>

2. 测试代码兼容处理 #

用预编译指令处理不同框架的API或测试特性差异，示例代码如下：

using System;
#if NET40_OR_LESS
using Microsoft.VisualStudio.TestTools.UnitTesting;
#else
using Microsoft.VisualStudio.TestTools.UnitTesting;
// 若切换为xUnit/NUnit，替换为对应命名空间即可
#endif

namespace YourLibrary.Tests
{
    [TestClass]
    public class CompatibilityTests
    {
        [TestMethod]
        public void TestBasicFunctionality()
        {
            // 通用测试逻辑
            var result = YourLibrary.SomeMethod();
            Assert.IsNotNull(result);

            // 针对老框架的特殊兼容处理
#if NET20
            // .NET 2.0不支持的API，用替代实现
            Assert.AreEqual("ExpectedResult", result.ToString());
#endif
        }
    }
}

3. 稳定执行测试的策略 #

避免依赖Visual Studio UI执行（老框架易出现执行遗漏或不稳定），推荐用命令行工具批量执行：

方式1：用dotnet test（适配大部分框架） #

# 遍历所有目标框架执行测试
dotnet test --no-restore --verbosity normal

方式2：针对.NET Framework <4.5单独用vstest.console.exe #

如果dotnet test对老框架支持不佳，直接调用Visual Studio自带的测试运行器：

# 示例：执行.NET 2.0测试
vstest.console.exe .\bin\Debug\net20\YourLibrary.Tests.dll

你可以编写简单的PowerShell脚本，遍历所有目标框架的测试dll，自动调用对应运行器完成全量测试。

4. 常见问题解决 #

• .NET 2.0/3.5测试失败：确保MSTest v1包引用正确，不要混用v2适配器；老框架需提前安装对应.NET Framework运行时和SDK。
• 部分框架测试未执行：检查测试项目输出路径，确认每个框架的测试dll已生成；添加--verbosity detailed参数查看测试运行器日志定位问题。
• 执行不稳定：保持项目配置中禁用并行测试的设置，避免老框架资源竞争；每次执行前清理项目再重新构建。

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