文本模式
CukeTest 编辑 剧本文件 (Feature) 提供了文本模式和可视模式两种编辑方式。本节重点介绍文本模式。
什么是文本模式?
文本模式 提供了一个基于纯文本的代码编辑界面。当从可视模式切换至文本模式时,界面内容将被还原为原始的 Gherkin 语法。
文本模式的使用场景
文本模式非常适合以下场景:
- 需要大段复制、粘贴或修改脚本内容。
- 需要使用
Ctrl + H进行批量查找与替换。 - 习惯使用键盘快捷键进行高效编辑。
文本模式的功能
CukeTest 为文本模式提供了多项智能化的辅助工具,以提升编辑效率和准确性。
1. 智能代码提示
在编辑过程中,CukeTest 会根据输入内容自动弹出 Cucumber 关键字建议。
- 例如,键入字母
F时,系统会提示Feature及其对应的中文映射功能,按回车键即可自动补全。
2. 实时语法诊断
文本模式会在编辑过程中实时检查 Gherkin 语法,并在行号左侧显示错误图标或红色波浪线,精确定位语法问题。
常见的受控语法错误包括:
- 标点符号错误:例如在中文环境下误用了全角冒号(
功能:)。正确的格式为:关键字后接半角冒号(:)并紧跟至少一个空格。 - 层级结构错误:例如在未声明
Scenario(场景) 的情况下直接编写步骤。 - 关键字语言冲突:如果文件头部声明了语言(如
# language: zh-CN),则正文应使用对应的中文关键字。混合使用不同语言的关键字会导致语法报错。
Tip
语法说明:在英文 Gherkin 语法中,关键字(如 Given)后必须带空格。在中文 Gherkin 语法中,关键字(如 假如、当)后可以不带空格,直接连接后续文本。
Warning
注意:语法锁定
如果当前文本包含语法错误(红色提示),系统将限制切换至可视模式。
在切换前,CukeTest 会进行语法验证。用户必须修正所有导致解析失败的语法问题,待错误提示消失后,方可切换回可视模式。