SpecFlow 4.x 要求 .NET 6+，低版本会导致 .feature.cs 为空、测试不可见；需确认 TargetFramework、安装 SpecFlow.Tools.MsBuild.Generation、避免 Gherkin 语法错误、正确绑定步骤、配置 NUnit 适配器并重建项目验证生成结果。
SpecFlow 项目初始化失败：.NET SDK 版本不兼容
SpecFlow 4.x 要求 .NET 6+，若你用的是 .NET Core 3.1 或 .NET 5，默认安装 SpecFlow.NUnit 或 SpecFlow.Tools.MsBuild.Generation 会静默失败——生成的 .feature.cs 文件为空，测试发现器也看不到任何场景。
实操建议：
- 确认项目 SDK：检查
.csproj中是否含net6.0（或更高） - 卸载旧包：
dotnet remove package SpecFlow.NUnit，再安装匹配版本：dotnet add package SpecFlow.NUnit --version 4.12.0 - 必须添加
SpecFlow.Tools.MsBuild.Generation（非可选）；SpecFlow 4+ 不再通过packages.config或全局工具管理生成逻辑 - 编辑
.csproj，确保包含
Feature 文件语法错误导致生成中断：Gherkin 解析失败
哪怕一个中文顿号、多缩进一格、Scenario Outline 缺少 Examples 表，都会让 MSBuild 在生成阶段报 MSB4018: The "GenerateFeatureFileCodeBehindTask" task failed unexpectedly，且错误位置常指向生成任务而非 .feature 文件本身。
实操建议：
- 用 VS 插件 SpecFlow for Visual Studio（非必装但强烈推荐），它会在编辑时实时标红语法问题
-
Given/When/Then后必须接空格，不能紧贴冒号，例如Given用户已登录❌ → 应为Given 用户已登录✅ - 避免在
Examples表中使用竖线|作为数据内容；如需保留，用双引号包裹：| "a|b" | - 中文关键字需在
specflow.json中显式声明，否则解析器按英文识别，直接跳过整段
Step Definition 绑定失败：正则不匹配或上下文未激活
运行测试时看到 -> Pending 或 System.NullReferenceException，大概率是 [Given] 方法没被找到。SpecFlow 不靠方法名绑定，只认正则表达式和参数类型。
实操建议：
- 不要手动写正则——用
[Given("用户输入 (.*)")]比[Given(@"用户输入 (.*)")]更安全（后者需转义反斜杠） - 参数类型必须与正则捕获组数量 & 类型严格一致：
Given("余额为 (\\d+) 元")对应public void Given余额为_元(int amount)，不能是string amount - 确保 Step Definition 类加了
[Binding]，且所在程序集被 SpecFlow 扫描到（默认扫描同项目所有[Binding]类） - 若用依赖注入（如
ScenarioContext或自定义服务），必须在specflow.json中启用"stepAssemblies": [ { "assembly": "YourTestAssembly" } ]
NUnit 运行器无法识别 SpecFlow 场景：缺少适配器或配置错位
编译成功、生成了 .feature.cs，但 Test Explorer 里完全不显示任何测试项，或显示为灰色“未加载”。这通常不是代码问题，而是执行链断在 NUnit 和 SpecFlow 的桥接层。
实操建议：
- 安装
SpecFlow.NUnit后，必须同时安装对应版本的NUnit3TestAdapter（不是NUnit.TestAdapter） - 检查
.csproj是否意外设置了true——它会屏蔽 NUnit 适配器自动注册 - VS 中右键解决方案 → “重新生成”，不要只点单个测试类；SpecFlow 生成逻辑依赖完整构建流程
- 命令行调试时用
dotnet test --logger:"console;verbosity=detailed"，看输出里是否出现Discovered test: xxx.feature
SpecFlow 的真正复杂点不在语法或步骤绑定，而在于生成管道与构建系统的耦合深度——一旦 .feature.cs 没生成出来，整个链条就断了，且错误提示往往藏在 MSBuild 日志深处。最省时间的做法，是每次新增 feature 文件后，先 clean + rebuild 整个项目，再打开生成的 .feature.cs 看一眼内容是否合理。
