xUnit 如何通过dotnet test CLI执行指定InlineData的单个Theory测试

方案1：直接通过测试显示名精准过滤（零额外代码，最简便） #

xUnit为每个InlineData生成的测试实例都有固定的全局唯一显示名，格式为 完整类名.完整方法名(参数字面值)，对应你给出的测试用例，两个实例的显示名分别是：

• MyTestNamespace.MyTestClass.ShouldSelectSingleTheoryFromDotnetTest("one")
• MyTestNamespace.MyTestClass.ShouldSelectSingleTheoryFromDotnetTest("two")

dotnet test 的 --filter 参数原生支持匹配测试显示名，无需编写任何额外测试代码，直接执行以下命令即可只运行入参为"one"的实例：

# Bash 环境
dotnet test --filter "DisplayName~ShouldSelectSingleTheoryFromDotnetTest(\"one\")"

注意：不同Shell环境下引号转义规则有差异，PowerShell环境下可使用单引号包裹过滤表达式，避免转义问题：dotnet test --filter 'DisplayName~ShouldSelectSingleTheoryFromDotnetTest("one")'
匹配语法中~代表包含匹配，无需写全完整命名空间与类名，只要表达式能唯一匹配到目标测试用例即可，也可以使用=做完全匹配。

方案2：为单条InlineData单独关联Trait（适合需要标签化管理测试的场景） #

不要直接在测试方法上标注[Trait]，这种方式会把同一个Trait应用到方法下所有InlineData生成的测试实例，无法实现单条数据的标签区分。
正确做法是自定义带Trait能力的InlineData派生特性，让Trait和单条数据绑定：

1. 编写自定义的带Trait的InlineData特性，兼容任意数量的InlineData入参：

   public class TraitedInlineDataAttribute : InlineDataAttribute
   {
       // 支持任意数量的InlineData参数，前两个参数传入Trait的键和值
       public TraitedInlineDataAttribute(string traitKey, string traitValue, params object[] values) : base(values)
       {
           AddTrait(traitKey, traitValue);
       }
   }
   

2. 替换原有测试方法上的InlineData标记，为每条入参绑定独立的Trait：

   [Theory]
   [TraitedInlineData("Group", "FirstCase", "one")]
   [TraitedInlineData("Group", "SecondCase", "two")]
   // 支持多参数的InlineData写法
   [TraitedInlineData("Group", "MultiParamCase", "test", 123, true)]
   public void ShouldSelectSingleTheoryFromDotnetTest(string s)
   {
       Assert.True(true);
   }
   

3. 执行命令时直接用常规Trait筛选逻辑即可定位到目标用例：

   dotnet test --filter "Trait[Group]=FirstCase"
   

常见注意事项 #

• 你之前考虑的环境变量+动态跳过的方案属于绕路：dotnet test的过滤逻辑在测试主机启动、测试用例加载的阶段就完成筛选，不符合条件的用例不会被纳入执行计划、也不会加载执行，运行效率远高于“先加载所有用例、再在测试方法内部判断是否跳过”的方案，完全不需要额外在测试代码里读命令行参数或者环境变量做判断
• 如果InlineData传入的是复杂类型参数，DisplayName中存储的是参数对象ToString()后的序列化值，简单字符串、值类型参数可直接按字面量匹配
• 不要给测试方法整体加Trait，否则所有派生的Theory实例会共享同一个标签，无法实现单条数据的区分

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