MSTest框架默认忽略指定测试、仅显式传参触发执行的实现方法咨询

无需拆分项目的3种可行实现方式 #

方案1：基于测试类别特性+默认过滤规则（最常用） #

该方案不需要修改测试逻辑，仅通过特性标记和配置实现自动过滤，适配多项目统一执行场景：

• 第一步：给需要条件执行的测试类添加[TestCategory]特性，标记专属分类，类级别的标记会自动应用到类下所有测试方法，无需逐个方法重复标记

[TestClass] // 始终执行的普通测试类
public class SomeTests 
{
    [TestMethod]
    public void Test1(){}
}

[TestClass, TestCategory("ExternalDependent")] // 仅条件执行的测试类
public class SomeTests2
{
    [TestMethod]
    public void Test1(){}

    [TestMethod]
    public void Test2(){}
}

• 第二步：实现默认过滤，两种配置方式二选一即可：
  1. 单项目配置：在测试项目的.csproj文件中添加默认参数，执行dotnet test时自动生效

  <Project Sdk="Microsoft.NET.Sdk">
    <PropertyGroup>
      <!-- 其他原有配置 -->
      <TestArguments>--filter "TestCategory!=ExternalDependent"</TestArguments>
    </PropertyGroup>
  </Project>
  

  2. 多项目全局配置：统一执行全量测试时直接在命令上加过滤参数，不需要修改任何项目代码

  dotnet test --filter "TestCategory!=ExternalDependent"
  

• 触发执行条件测试的方式：手动指定筛选参数即可

dotnet test --filter "TestCategory=ExternalDependent"

方案2：基于环境变量的条件忽略特性（灵活度最高） #

该方案通过自定义测试特性实现逻辑判断，不需要额外配置执行参数，仅靠环境变量控制是否执行：

• 第一步：实现自定义条件执行特性

public class RunOnlyWithEnvVarAttribute : TestMethodAttribute
{
    private readonly string _targetEnvVar;
    public RunOnlyWithEnvVarAttribute(string targetEnvVar)
    {
        _targetEnvVar = targetEnvVar;
    }

    public override TestResult[] Execute(ITestMethod testMethod)
    {
        // 未检测到指定环境变量时直接跳过测试
        if (string.IsNullOrEmpty(Environment.GetEnvironmentVariable(_targetEnvVar)))
        {
            return new[]
            {
                new TestResult 
                { 
                    Outcome = UnitTestOutcome.Ignore, 
                    TestFailureException = new AssertInconclusiveException($"未检测到环境变量{_targetEnvVar}，跳过外部依赖测试") 
                }
            };
        }
        return base.Execute(testMethod);
    }
}

如果需要类级别全局生效，可以自定义TestClassAttribute的子类，给类下所有方法自动应用上述逻辑。

• 第二步：给需要条件执行的测试方法/类贴特性

[TestClass]
public class SomeTests2
{
    [TestMethod, RunOnlyWithEnvVar("RUN_EXTERNAL_TESTS")]
    public void Test1(){}

    [TestMethod, RunOnlyWithEnvVar("RUN_EXTERNAL_TESTS")]
    public void Test2(){}
}

• 触发执行条件测试的方式：运行前设置对应环境变量即可
  Windows环境：

set RUN_EXTERNAL_TESTS=true
dotnet test

Linux/macOS环境：

export RUN_EXTERNAL_TESTS=true
dotnet test

方案3：基于.runsettings配置文件（适合多项目统一规则） #

如果解决方案下有大量测试项目，可以用统一的配置文件管理过滤规则，不需要逐个修改项目配置：

• 第一步：在解决方案根目录新建test.runsettings文件，内容如下：

<?xml version="1.0" encoding="utf-8"?>
<RunSettings>
  <RunConfiguration>
    <TestCaseFilter>TestCategory!=ExternalDependent</TestCaseFilter>
  </RunConfiguration>
</RunSettings>

• 第二步：默认执行时指定配置文件即可自动过滤：

dotnet test --settings test.runsettings

需要运行外部依赖测试时，修改配置文件的过滤规则或者手动指定筛选参数即可。

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