剧本编辑概述
本节引导您了解 CukeTest 的核心文档类型——剧本文件（Feature文件）是什么，以及如何在 CukeTest 中高效地进行预览与编辑。
什么是剧本文件？
剧本文件（通常以 .feature 为后缀）是 BDD（行为驱动开发）中的核心资产。你可以把它理解为用大白话写的测试用例。
- 为什么叫“剧本”？ 因为它像拍电影的剧本一样，描述了用户在使用软件时会发生的一个个场景连贯的故事。
- 有什么用？ 剧本文件不仅研发人员能看懂，业务人员、测试人员也都能看懂。它既是需求文档，又是可以自动执行的自动化测试脚本的基础。
编辑视图
在 CukeTest 中打开剧本文件时，您可以选择两种不同的编辑视图：可视模式 和 文本模式。
下图展示了这两种视图的界面：左侧是可视模式，右侧是文本模式：
您可以通过点击编辑器右上角的切换按钮（
/ 
）在这两种视图之间来回切换。
如何选择视图？
| 视图类型 | 适合谁用 / 何时用 | 核心特点 |
|---|---|---|
| 可视模式 | 小白、非技术人员，或初次搭建场景时 | 界面像表格一样直观，通过双击和右键点击即可操作，不容易出现排版格式或语法的错误。 |
| 文本模式 | 熟练掌握语法的技术人员，或需要大段复制粘贴时 | 直接编辑底层纯文本，支持快捷键和代码补全，适合高效的批量修改。 |
Tip
提示：多个剧本文件可以同时打开，每个文件都可以在独立的选项卡中以自己的模式编辑。
文档编辑与项目编辑
CukeTest 支持以两种不同的方式工作：
- 文档模式：直接双击打开单个或多个孤立的剧本文件进行编辑。
- 项目模式：打开一整个包含测试代码（如关联的 Cucumber.js / pytest-bdd 步骤定义）的项目文件夹。
| 功能特性 | 文档模式 | 项目模式 |
|---|---|---|
| 运行测试脚本 | ❌ 无法运行（因为缺少与之绑定的代码实现） | ✅ 可直接运行整个项目或单个自动化测试 |
| 左侧文件树导航 | ❌ 不显示 | ✅ 显示完整的项目目录结构 |
| 代码生成等高级功能 | ❌ 无法使用 | ✅ 可根据剧本自动生成对应的代码片段和模版 |
Note
结论：如果你只是想浏览写好的需求剧本，使用文档模式即可。但如果你要进行完整的自动化测试开发，请务必以项目模式（打开整个文件夹）进入。
项目验证
当你在项目模式下编写了错综复杂的场景与代码后，如何确保它们没有低级错误呢？
用户可以通过点击菜单栏中的 运行 - 验证项目 （或点击工具栏上的勾选图标）来自动化检查当前项目的健康状态。
验证项能查出什么？
这是一种提前“排雷”的机制，通过它，您可以快速识别出可能导致后续运行失败的错误或警告。例如：
- 场景大纲中缺少示例表：你声明了一个需要传参的场景模板，却忘记给它表格数据。
- 步骤没有匹配的代码实现：你在剧本里写了一个步骤，但在背后的 JavaScript 中没有找到对应的自动化动作。
- 一个步骤匹配到多种脚本实现：你的代码中出现了冲突的正则表达式或重复定义。
- 存在未实现的步骤定义代码：代码虽然存在，但是状态为“处理中”（Pending），尚未写完真实逻辑。
- JavaScript / Python 语法错误：伴随代码层面的基本语法检验。
执行后，错误结果会展示在下方面板中，双击可直接定位出错原因：
