📚 课程目录第2章使用RIDE编写测试用例

2. 使用RIDE编写测试用例

任务说明

本案例目标为：安装RIDE编辑器，通过其图形界面创建测试套件和测试用例，并运行测试。RIDE是RobotFramework的官方图形化IDE，适合不熟悉命令行或偏好可视化操作的用户。完成本案例后，你将拥有一个可运行的RIDE环境，并掌握从创建项目到执行测试的完整图形化操作路径。

环境准备与安装

RIDE依赖Python环境，请确保已安装Python 3.8及以上版本。使用pip安装RIDE及其核心依赖：

pip install robotframework
pip install robotframework-ride

安装完成后，在命令行输入ride或python -m robotide启动RIDE。首次启动会提示选择工作区目录，选择一个用于存放测试项目的文件夹即可。

创建测试套件与测试用例

RIDE启动后，左侧为项目浏览器（Project Explorer），右侧为编辑器区域。按以下步骤创建测试套件和用例：

在项目浏览器中，右键点击工作区根节点，选择New Suite，输入套件名称DemoSuite，格式选择ROBOT，点击OK创建测试套件文件。
在左侧选中DemoSuite，右侧编辑器下方有Text Edit和Grid Edit两个标签页。在Text Edit中可直接编写RobotFramework语法，本案例使用图形化方式，因此切换到Grid Edit标签页。
在Grid Edit中，表格行对应套件的不同部分。第一行Setting区域用于导入库，点击Library单元格，输入BuiltIn（RobotFramework内置库，提供日志、断言等基础关键字）。
在Test Case表格区域，第一列输入用例名称MyFirstTest，第二列输入关键字Log，第三列输入参数Hello from RIDE。如需添加断言，可增加一行，关键字为Should Be Equal，参数为${1+1}和2。

完成后的Grid Edit视图应包含以下内容：

Setting          Value
Library          BuiltIn

Test Case        Keyword          Argument
MyFirstTest      Log              Hello from RIDE
                 Should Be Equal  ${1+1}    2

运行测试与结果验证

点击工具栏中的Run按钮（绿色三角形），RIDE会弹出运行配置对话框。默认配置即可，点击OK开始执行。运行过程中，RIDE底部的Run标签页会实时显示日志输出。执行完成后，可通过以下方式验证结果：

观察Run标签页中是否显示PASS状态，以及MyFirstTest用例是否标记为绿色通过。
点击Report按钮，RIDE会自动在浏览器中打开HTML格式的测试报告，报告中应显示1 test, 1 passed, 0 failed。
点击Log按钮可查看详细日志，其中应包含Hello from RIDE的日志条目。

判定标准：若Run标签页显示MyFirstTest为PASS，且Report中统计为1个测试全部通过，则本案例目标达成。

RIDE界面与操作流程

下图展示了RIDE的核心界面布局与测试执行的数据流向，帮助理解图形化操作背后的逻辑关系：

┌─────────────────────────────────────────────────────────────────┐
│                    RIDE 主界面布局                              │
│                                                                 │
│  ┌───────────────┐  ┌───────────────────────────────────────┐  │
│  │ 项目浏览器     │  │  编辑器区域                            │  │
│  │ (Project      │  │  ┌─────────────────────────────────┐  │  │
│  │  Explorer)    │  │  │ Grid Edit 表格                  │  │  │
│  │               │  │  │ Setting │ Value                 │  │  │
│  │ DemoSuite     │  │  │ Library │ BuiltIn               │  │  │
│  │   └ MyFirst   │  │  ├─────────────────────────────────┤  │  │
│  │     Test      │  │  │ Test Case │ Keyword   │ Argument│  │  │
│  │               │  │  │ MyFirst   │ Log       │ Hello   │  │  │
│  │               │  │  │ Test      │ Should Be │ ${1+1}  │  │  │
│  │               │  │  │           │ Equal     │ 2       │  │  │
│  └───────────────┘  │  └─────────────────────────────────┘  │  │
│                     │  ┌─────────────────────────────────┐  │  │
│                     │  │ Run 标签页（实时日志输出）        │  │  │
│                     │  │ Test: MyFirstTest PASS          │  │  │
│                     │  └─────────────────────────────────┘  │  │
│  ┌───────────────┐  └───────────────────────────────────────┘  │
│  │ 工具栏         │                                             │
│  │ ▶Run  Report  │  Report按钮 → 浏览器打开HTML报告            │
│  │ Log           │  Log按钮   → 浏览器打开详细日志             │
│  └───────────────┘                                             │
└─────────────────────────────────────────────────────────────────┘

图中左侧项目浏览器管理套件文件，中间Grid Edit以表格形式编辑用例，底部Run标签页展示执行日志，Report和Log按钮分别生成可视化报告与日志文件。

常见问题排查

若运行时报错No keyword with name 'Should Be Equal' found，请检查Setting表格中是否已正确导入BuiltIn库。若RIDE界面无法正常显示，可尝试以管理员权限运行，或升级wxPython依赖：pip install -U wxPython。若需在命令行验证同一用例，可执行robot DemoSuite.robot，结果应与RIDE运行一致。