0

0

C# Gherkin feature文件解析 C#如何读取SpecFlow或Cucumber的.feature文件

煙雲

煙雲

发布时间:2026-02-19 03:21:36

|

884人浏览过

|

来源于php中文网

原创

应使用官方gherkin nuget包解析.feature文件:创建parser→parse()得feature ast→遍历children筛选scenario→取tags.name和name字段;specflow不提供运行时解析api,正则或手动读取易出错。

c# gherkin feature文件解析 c#如何读取specflow或cucumber的.feature文件

SpecFlow 的 .feature 文件不是运行时读取的源文件

它不会被 C# 程序直接“解析”成可执行逻辑——.feature 文件只在 SpecFlow 编译阶段(即生成 *.feature.cs 文件时)被读取一次,之后就被丢弃。你看到的测试方法、步骤绑定、场景上下文,全来自生成的 C# 类,而不是运行时重新加载 .feature 文件。

所以,如果你的目标是“在运行时打开一个 login.feature,提取出所有 @smoke 场景”,这不是 SpecFlow 设计要解决的问题;它是 Gherkin 解析问题,得绕过 SpecFlow 自己动手。

  • SpecFlow 不提供公开 API 读取或遍历 .feature 文件内容
  • SpecFlow.Tools.Parser 是内部类,不推荐引用,且随版本变动大
  • 强行用 File.ReadAllText + 正则去“解析” Gherkin 文本极易出错(缩进、多行字符串、注释、表格边界)

真要读 .feature 文件,用官方 Gherkin NuGet 包

这是唯一靠谱的方式:用 Cucumber 官方维护的 Gherkin 库(.NET 版),它专为解析 Gherkin 文本设计,能正确处理关键字、注释、数据表、文档字符串、标签嵌套等。

安装:dotnet add package Gherkin

核心流程就是:创建 Parser → 调用 Parse() → 得到 Feature AST 对象 → 遍历 Feature.Children(每个是 ScenarioScenarioOutline)。

PDFlux
PDFlux

PDF内容提取+智能问答神器,结合了科研级精准的非结构化文档解析能力,以及ChatGPT的智能问答能力。

下载
  • 支持全部 Gherkin 6+ 语法,包括 Examples 表格中的 | 分隔和换行符保留
  • 返回的是强类型对象(Feature, Scenario, Step, Tag),不是字符串切片
  • 不依赖 SpecFlow,也不影响编译流程,纯运行时解析
  • 注意:Parser.Parse() 接收的是 TextReader,别直接传路径字符串——要用 new StringReader(content)File.OpenText(path)

Gherkin.Parser 解析后怎么取标签和场景名

拿到 Feature 对象后,标签在 Feature.Tags(顶层标签),每个 Scenario 自己也有 Tags 属性;场景名是 Scenario.Name,不是 Scenario.Id(后者是内部哈希 ID)。

示例片段:

var parser = new Parser();
var feature = parser.Parse(new StringReader(File.ReadAllText("login.feature")));
foreach (var child in feature.Children)
{
    if (child is Scenario scenario)
    {
        var tags = scenario.Tags.Select(t => t.Name).ToArray(); // 如 ["@smoke", "@regression"]
        var name = scenario.Name; // "User logs in with valid credentials"
        var steps = scenario.Steps.Select(s => s.Text).ToList();
    }
}
  • scenario.TagsIReadOnlyList<tag></tag>Tag.Name@ 符号,如 "@smoke"
  • 多行步骤(如 """...""" 或表格)的文本内容在 Step.Argument 中,需判断类型(DataTable / DocString)再取值
  • 不要假设 Children 顺序恒定——Gherkin 允许 Background 插在中间,需用 is Scenariois ScenarioOutline 判断类型

为什么不用正则或 StreamReader 手动拆?

因为 Gherkin 不是行格式文本,而是结构化文档:关键词大小写不敏感(Given/given 都合法)、空行不终止场景、表格列对齐无意义、Examples 可能跨多行、注释可出现在任意行首(#),还有嵌套的 ScenarioOutline + Examples 组合。

  • 用正则匹配 @.* 会漏掉写在 Scenario 下面的标签(Gherkin 允许)
  • 按空行分割会把带空行的 DocString 错切成两段
  • 忽略缩进会导致把 Then 步骤误判成新 Scenario
  • Gherkin 库内部用状态机解析,已覆盖所有边缘 case,自己重写成本高、维护难、易崩

真正麻烦的点不在“怎么读”,而在于你得想清楚:读出来之后做什么?渲染成 HTML?做覆盖率统计?还是动态启用/跳过某些场景?这些需求决定了你要取哪些字段、怎么缓存 AST、是否需要合并多个 .feature 文件——而这些,Gherkin 库只管解析,不管业务逻辑。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

553

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

216

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1553

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

640

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

945

2024.03.22

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

896

2024.04.29

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

185

2025.07.29

c++字符串相关教程
c++字符串相关教程

本专题整合了c++字符串相关教程,阅读专题下面的文章了解更多详细内容。

89

2025.08.07

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

561

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 9.7万人学习

C 教程
C 教程

共75课时 | 4.8万人学习

C++教程
C++教程

共115课时 | 18.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号