如何从外部JSON文件为SpecFlow场景大纲提供输入替代Examples？

结论：完全可以实现，下面是具体的落地步骤，全程基于SpecFlow和测试框架（以NUnit为例）的原生能力，无需额外第三方扩展。

具体实现步骤 #

1. 准备JSON测试数据文件 #

在测试项目里新建一个专门存放测试数据的目录（比如TestData），创建JSON文件（命名为AddNumbersData.json），内容如下：

[
  {
    "Value1": 2,
    "Value2": 3,
    "Expected result": 5
  },
  {
    "Value1": 2,
    "Value2": 5,
    "Expected result": 7
  }
]

关键设置：右键该JSON文件，在属性里把「复制到输出目录」改为「如果较新则复制」，确保测试运行时能找到这个文件。

2. 创建数据模型类 #

写一个C#类，用来映射JSON里的字段，解决JSON键名带空格的匹配问题：

using System.Text.Json.Serialization;

public class AddNumbersTestData
{
    public int Value1 { get; set; }
    public int Value2 { get; set; }
    
    // 用特性匹配JSON中带空格的键名
    [JsonPropertyName("Expected result")]
    public int ExpectedResult { get; set; }
}

3. 封装JSON读取逻辑 #

写一个工具类，负责读取JSON文件并转换成数据模型列表：

using System.Collections.Generic;
using System.IO;
using System.Text.Json;
using NUnit.Framework;

public static class TestDataLoader
{
    public static List<T> LoadFromJson<T>(string relativePath)
    {
        // 获取测试运行时的文件绝对路径
        var fullPath = Path.Combine(TestContext.CurrentContext.TestDirectory, relativePath);
        var jsonContent = File.ReadAllText(fullPath);
        return JsonSerializer.Deserialize<List<T>>(jsonContent);
    }
}

4. 修改Feature文件 #

把原来的Scenario Outline改成普通Scenario（也可以保留Scenario Outline但删掉Examples块），示例如下：

Feature: Number Addition
    Scenario: Add two numbers with external JSON data
        Given the first number is <Value1>
        And the second number is <Value2>
        When the two numbers are added
        Then the result should be <ExpectedResult>

5. 实现数据驱动的步骤绑定 #

结合NUnit的TestCaseSource特性，让测试自动遍历JSON里的每一组数据：

using NUnit.Framework;
using System.Collections.Generic;

[Binding]
public class AddNumbersSteps
{
    private int _value1;
    private int _value2;
    private int _calculatedResult;

    // 提供测试数据来源
    public static IEnumerable<AddNumbersTestData> GetAdditionTestData()
    {
        return TestDataLoader.LoadFromJson<AddNumbersTestData>("TestData/AddNumbersData.json");
    }

    // 数据驱动的测试入口，自动遍历每一组JSON数据
    [TestCaseSource(nameof(GetAdditionTestData))]
    public void ExecuteAdditionTest(AddNumbersTestData testData)
    {
        // 模拟执行Gherkin步骤的逻辑
        _value1 = testData.Value1;
        _value2 = testData.Value2;
        _calculatedResult = _value1 + _value2;

        // 验证结果
        Assert.AreEqual(testData.ExpectedResult, _calculatedResult);
    }

    // 如果需要保留原有的Gherkin步骤绑定（用于单独调试），可以保留以下代码
    [Given(@"the first number is (\d+)")]
    public void GivenTheFirstNumberIs(int value1)
    {
        _value1 = value1;
    }

    [Given(@"the second number is (\d+)")]
    public void GivenTheSecondNumberIs(int value2)
    {
        _value2 = value2;
    }

    [When(@"the two numbers are added")]
    public void WhenTheTwoNumbersAreAdded()
    {
        _calculatedResult = _value1 + _value2;
    }

    [Then(@"the result should be (\d+)")]
    public void ThenTheResultShouldBe(int expectedResult)
    {
        Assert.AreEqual(expectedResult, _calculatedResult);
    }
}

可选方案：保留Scenario Outline的原生语法 #

如果想继续用Scenario Outline的写法，可以通过实现SpecFlow的IScenarioOutlineDataSource接口自定义数据源扩展，但上述原生方式已经能满足绝大多数场景，且无需额外编写扩展代码。

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