Specflow 3.9.22如何将场景大纲的凭证等重要信息存放至独立文件

以下3种方案均满足「敏感信息存在本地独立文件、不提交到仓库、场景大纲代码可正常读取参数」的需求：

方案1：本地JSON/CSV配置文件 + 钩子预加载 #

这是实现成本最低的方案，适配任意格式的外部数据文件：

• 第一步：在项目根目录新建凭证文件，比如test-credentials.json，文件内按组存储多组凭证，示例结构：

[
  {"cred_id": "test_user_1", "username": "xxx@test.com", "password": "xxxxxx", "env": "test"},
  {"cred_id": "prod_user_1", "username": "yyy@prod.com", "password": "yyyyyy", "env": "prod"}
]

• 第二步：将test-credentials.json添加到.gitignore规则中，同时在仓库中提交test-credentials.template.json模板文件（所有敏感值留空），方便团队成员参考填充本地文件
• 第三步：在Specflow项目的钩子类中添加[BeforeTestRun]方法，读取本地凭证文件内容存入TestRunContext，示例代码：

[BeforeTestRun]
public static void LoadCredentials(TestRunContext testRunContext)
{
    var credPath = Path.Combine(testRunContext.TestDirectory, "test-credentials.json");
    if (!File.Exists(credPath))
        throw new FileNotFoundException("请先按模板填充test-credentials.json文件", credPath);
    var credentials = JsonConvert.DeserializeObject<List<Credential>>(File.ReadAllText(credPath));
    testRunContext.Set(credentials, "TestCredentials");
}

• 第四步：场景大纲的Example中仅填写非敏感的cred_id标识，在步骤绑定代码中根据cred_id从TestRunContext中取出对应凭证值使用即可。

方案2：实现IExternalDataLoader接口扩展外部数据源 #

如果你需要和原来Specflow.Plus.Excel一致的使用体验（直接将外部文件内容作为场景大纲的示例数据），可以用Specflow 3.x新增的IExternalDataLoader扩展接口：

• 第一步：自定义类实现IExternalDataLoader接口，编写读取本地Excel/CSV文件的逻辑，将文件内容转换为Specflow可识别的示例行数据集
• 第二步：给需要读取外部凭证的场景大纲添加自定义标签，比如@ExternalDataSource:credentials.xlsx，在加载器逻辑中识别该标签读取对应文件
• 第三步：将credentials.xlsx添加到.gitignore，.feature文件仅保留标签和场景逻辑，不会泄露敏感信息。

方案3：使用.NET用户机密（User Secrets）存储凭证 #

如果不想在项目目录下存放敏感文件，可以用.NET内置的用户机密功能，凭证文件天然不会被提交到仓库：

• 第一步：右键Specflow项目，选择「管理用户机密」，自动打开用户目录下的secrets.json文件，按组存储凭证
• 第二步：在项目中注入IConfiguration实例，可直接读取用户机密中的凭证内容
• 第三步：场景大纲的Example中仅填写凭证组ID，步骤绑定中根据ID从IConfiguration读取对应凭证值即可。

通用注意事项 #

• 团队协作时需要在README中说明凭证文件的获取/填充方式，避免新成员运行用例时报错
• CI/CD环境运行时，可直接将凭证存入CI系统的保密变量，运行测试前动态生成对应的凭证文件即可

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