Excel2Gherkin 实操：用 Excel 表格编写 BDD 测试用例，支持中文与数据驱动

在软件开发中，行为驱动开发（BDD）是提升软件质量与团队协作效率的关键实践。它使用近乎自然语言的语法来描述测试场景，目标是让开发者、测试人员乃至业务分析师都能无障碍地理解和参与。

但理想很丰满，现实常让人头疼。传统的BDD测试用例通常写在 .feature 文件中，使用 Gherkin 语法。这带来了几个实际问题：

• 语法是英文的，对中文团队不友好。
• 手动编写和维护 .feature 文件容易出错，格式敏感。
• 管理和维护大量的测试数据（尤其是数据驱动测试时）变得复杂。

对于非技术背景的团队成员（如产品经理、业务专家）来说，直接读写 Gherkin 文件门槛较高。有没有一种方法，能让他们用更熟悉的工具来贡献测试用例呢？

工具定位：Excel2Gherkin

Excel2Gherkin 这款工具的出现，正是为了解决上述痛点。它的目标非常明确：

• 让业务或测试人员通过最熟悉的 Excel 表格界面来编写和整理 BDD 测试用例。
• 自动将 Excel 内容转换为标准的 Gherkin .feature 文件。
• 生成的 .feature 文件可直接被 Cucumber、SpecFlow、Reqnroll 等主流 BDD 框架使用。
• 完美支持数据驱动测试，并能处理包含多工作表的复杂 Excel 文档。

简单来说，它的核心价值就是：在 Excel 里写测试用例，一键生成标准 Gherkin 文件，降低非技术人员参与自动化测试的门槛。

安装与使用

你可以通过文末提供的链接下载该工具。下载后，它是一个命令行工具，基本使用语法如下：

Excel2Gherkin [文件或路径] [选项]

主要参数说明

参数	含义
[文件或路径]	需要转换的 Excel 文件或包含 Excel 文件的目录路径。
-h, --help	显示帮助信息。
-v, --version	显示版本信息。
-e, --ext	指定生成的特征文件扩展名（默认为 .feature）。
-i, --incSubDir	是否处理子目录中的文件（默认为 false）。
-t, --tgtDir	指定保存生成的特征文件的目标目录。
-c, --cloak	启用隐身模式：不在特征文件头部添加日期/时间戳记。
-m, --match	与现有的特征文件进行匹配。
-x, --matchExt	指定要匹配的文件扩展名（默认为 .feature）。
-r, --matchDir	指定要匹配的目录。
-z, --zombie	启用僵尸模式：即使出现错误、异常或不匹配，也会继续处理所有文件。

Excel 关键字约定（支持中文！）

为了让转换过程准确无误，你需要在 Excel 中遵循特定的关键字约定。好消息是，这些关键字完全支持中文，极大方便了国内团队。

工作表名称约定

• 背景：此工作表的内容将被转换为 Gherkin 中的 Background 部分。
• 以 _（下划线）开头的工作表将被忽略，可用于存放说明或中间数据。

单元格关键字约定（A列）

在 A 列输入以下中文关键词，工具会将其识别并转换为对应的 Gherkin 语法。

中文（A列）	对应Gherkin输出
场景	场景:
场景大纲	场景大纲:
示例	示例:

表格识别规则

当需要定义数据表格（例如 场景大纲 下的 示例）时，遵循以下规则：

• 开始：当 A 列为空，而 B 列及之后列有内容时，识别为数据表格的开始。
• 结束：遇到一个所有单元格均为空的行时，表格结束。
• 转换：表格内容会自动生成为 Gherkin 标准的 | 管道符分隔格式。

实战转换示例

基础示例：登录测试

假设你有一个名为 登录测试 的 Excel 工作表，内容设计如下：

通过 Excel2Gherkin 转换后，会生成如下格式的标准 .feature 文件：

高级示例：数据驱动测试

对于更复杂的场景，如订单处理测试，你可以在 Excel 中利用多行数据轻松实现数据驱动测试。

转换后，复杂的场景大纲和示例数据会被完整地保留在 Gherkin 文件中，极大地简化了测试数据管理的复杂度。

使用建议与注意事项

使用建议：

1. 结构化设计：在 Excel 中严格按照 BDD 的 Given-When-Then 结构编写用例，保持逻辑清晰。
2. 关键字准确：务必使用工具约定的中文关键字（场景、场景大纲、示例、背景），避免使用错别字或近义词。
3. 善用表格：充分利用 Excel 的表格功能来管理复杂的测试数据，这是相比直接写 Gherkin 文件的巨大优势。
4. 分工作表管理：为不同的功能模块或测试场景创建不同的工作表，使用例库结构清晰、易于维护。

注意事项：

• 工具支持的 Excel 文件格式为 .xlsx。
• 生成的 .feature 文件与 Cucumber (Java/Ruby)、SpecFlow (.NET)、Reqnroll 等主流 BDD 框架完全兼容，可无缝集成到你的自动化软件测试流程中。
• 生成文件头部的时间戳格式会根据操作系统的区域设置自动生成。

工具下载

工具下载链接：https://pan.baidu.com/s/1Zmzep3MChS_QInk5eD7p0Q?pwd=c7cx

通过将熟悉的 Excel 与专业的 BDD 测试相结合，Excel2Gherkin 有效地在业务语言与技术实现之间搭建了一座桥梁。它不仅能提升非技术角色在质量保障活动中的参与度，也能让测试人员更高效地设计和维护用例。如果你正在团队中推广 BDD 或寻求提升测试用例的编写与管理效率，不妨试试这个思路。关于测试自动化的更多实践与工具讨论，欢迎在 云栈社区 的测试与运维板块与我们交流。