Flutter BDD测试报错：Unknown runnable child 'CommentLineRunnable'

这个错误的核心原因是你的Gherkin feature文件存在不符合规范的注释或格式问题，导致解析器无法正确识别内容。下面是具体的排查和解决步骤：

1. 检查feature文件的注释写法 #

Gherkin对注释有严格的格式要求，必须遵循以下规则：

• 注释必须以#开头，且单独占据一行
• 不能将注释与Feature:、Scenario:这类Gherkin关键字放在同一行
• 禁止使用//这类非Gherkin标准的注释符号

举个错误写法的例子：

Feature: 登录功能测试 // 验证用户登录流程
Scenario: 点击登录按钮 # 跳转到首页

正确的写法应该是：

验证用户登录流程 #

Feature: 登录功能测试

点击后跳转到首页 #

Scenario: 点击登录按钮

2. 清理feature文件中的无效内容 #

• 检查文件中是否存在多余的空行、不可见特殊字符（比如不同系统的换行符差异可能干扰解析）
• 确认所有Gherkin关键字（Given/When/Then等）拼写正确、大小写符合规范

3. 验证feature文件语法 #

你可以借助IDE的Gherkin插件（比如VS Code或IntelliJ的Gherkin支持插件）来实时检查语法，插件会高亮显示不符合规范的内容，帮你快速定位问题点。

补充说明 #

从你的test_config.dart代码来看，测试配置本身没有明显问题，错误栈指向GherkinParser.parseFeatureFile，说明问题完全出在feature文件的解析阶段，重点排查注释和文件格式即可。

内容的提问来源于stack exchange，提问作者L Uttama