SpecFlow 项目初始化失败：.NET SDK 版本不兼容
SpecFlow 4.x 要求 .NET 6+，若你用的是 .NET Core 3.1 或 .NET 5，默认安装
SpecFlow.NUnit或
SpecFlow.Tools.MsBuild.Generation会静默失败——生成的
.feature.cs文件为空，测试发现器也看不到任何场景。
实操建议：
确认项目 SDK：检查.csproj中是否含
<targetframework>net6.0</targetframework>（或更高） 卸载旧包：
dotnet remove package SpecFlow.NUnit，再安装匹配版本：
dotnet add package SpecFlow.NUnit --version 4.12.0必须添加
SpecFlow.Tools.MsBuild.Generation（非可选）；SpecFlow 4+ 不再通过
packages.config或全局工具管理生成逻辑 编辑
.csproj，确保包含
<packagereference include="SpecFlow.Tools.MsBuild.Generation" version="4.12.0" privateassets="all"></packagereference>
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是否意外设置了
<disableimplicitframeworkreferences>true</disableimplicitframeworkreferences>——它会屏蔽 NUnit 适配器自动注册 VS 中右键解决方案 → “重新生成”，不要只点单个测试类；SpecFlow 生成逻辑依赖完整构建流程 命令行调试时用
dotnet test --logger:"console;verbosity=detailed"，看输出里是否出现
Discovered test: xxx.featureSpecFlow 的真正复杂点不在语法或步骤绑定，而在于生成管道与构建系统的耦合深度——一旦
.feature.cs没生成出来，整个链条就断了，且错误提示往往藏在 MSBuild 日志深处。最省时间的做法，是每次新增 feature 文件后，先 clean + rebuild 整个项目，再打开生成的
.feature.cs看一眼内容是否合理。
