.NET单元测试：如何实现仅支持单独运行的自定义测试方法？

解决方案思路 #

无需修改现有大量[Fact]测试，通过自定义[FactAlone]属性结合环境变量判断实现需求：

• 构建机器（CI）环境自动跳过该类测试
• 本地批量运行测试时自动跳过，仅当单独右键运行时执行

自定义FactAloneAttribute实现 #

using System;
using System.Reflection;
using Xunit;
using Xunit.Sdk;

public class FactAloneAttribute : FactAttribute
{
    protected override void Before(MethodInfo methodUnderTest)
    {
        base.Before(methodUnderTest);

        // 1. CI环境直接跳过
        if (!string.IsNullOrEmpty(Environment.GetEnvironmentVariable("CI")))
        {
            throw new SkipException("FactAlone测试不在CI环境中执行");
        }

        // 2. 本地环境：检查是否为单独运行当前测试
        var testFilterEnv = Environment.GetEnvironmentVariable("VSTEST_TESTCASEFILTER");
        var currentTestFullName = $"{methodUnderTest.DeclaringType.FullName}.{methodUnderTest.Name}";

        // 无测试过滤器（批量运行）或过滤器不匹配当前测试时，跳过
        if (string.IsNullOrEmpty(testFilterEnv) || !testFilterEnv.Contains(currentTestFullName))
        {
            throw new SkipException("FactAlone测试仅允许单独执行");
        }
    }
}

方案说明 #

1. CI环境识别：大部分CI平台（如GitHub Actions、Azure DevOps、Jenkins）会自动设置CI环境变量，属性会检测该变量并直接跳过测试。
2. 本地运行判断：VS Test Runner或Resharper单独运行测试时，会自动设置VSTEST_TESTCASEFILTER环境变量，值包含当前测试的完整类名+方法名；批量运行时该变量为空或包含多个测试名称，因此会触发跳过逻辑。
3. 兼容性：完全兼容原有[Fact]测试，无需修改任何现有代码，仅需给需要单独运行的测试标记[FactAlone]即可。

注意事项 #

• 如果使用Resharper测试运行器，若VSTEST_TESTCASEFILTER未生效，可尝试检查RESHARPER_TEST_FILTER环境变量，替换代码中对应的变量名即可。
• 测试并行执行不影响逻辑，因为Before方法是每个测试实例执行前独立调用，环境变量的检查是可靠的。

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