RobotFramework自动化测试框架（快速入门）

1 RobotFramework框架介绍

Robot Framework 是一款基于 Python 的开源自动化测试框架，采用关键字驱动（Keyword-Driven）模式，支持验收测试（ATDD）和行为驱动开发（BDD）。其核心优势包括：

- 易用性：通过表格语法（TXT/TSV/HTML）编写用例，降低技术门槛。
- 关键字驱动：通过组合预定义或自定义关键字实现复杂逻辑。
- 跨平台支持：兼容 Windows、Linux、macOS，支持 Web、API、移动端（Android/iOS）、桌面应用等多类型测试。
- 高可扩展性：内置标准库（如 BuiltIn、Collections），支持 SeleniumLibrary（Web）、RequestsLibrary（API）、AppiumLibrary（移动端）等第三方库。
- 报告与日志：自动生成 HTML 格式测试报告，含执行时间、用例状态、日志详情。

2 环境搭建实战步骤

1. 安装 Python 与依赖
下载 Python 3.9+：官网，安装时勾选 Add Python to PATH。
验证安装：
python --version # 确认版本
pip --version # 确认pip可用

2. 安装 Robot Framework 核心库
pip install robotframework

3. 安装 RIDE 图形化工具（可选）
pip install wxpython # GUI库
pip install robotframework-ride # RIDE工具
RIDE是Robot Framework带图形界面测试编辑器

如安装失败，可能因为老版RIDE不支持python3，需要安装psutil和最新版的robotframework-ride
解决方法：
pip install psutil
pip install -U --pre robotframework-ride
注：-U升级安装，–pre查找预发行和正在开发的版本

4. 启动 RIDE
安装完成后桌面会有个RIDE快捷方式，桌面双击快捷方式。
如果桌面没有图标可从Python/Scripts中运行ride.py即可

5. 安装测试库（按需选择）
web自动化：
pip install robotframework-seleniumlibrary # 替代旧版Selenium2Library

API 测试：
pip install robotframework-requests

移动端测试：
pip install robotframework-appiumlibrary

3 RIDE 基础操作流程

1. 创建项目结构

• 创建项目：File → New Project，选择 Directory 类型（便于管理测试套件）。
  

• 创建测试套件：右键项目 → New Suite，选择 File 类型（支持创建用例）。
  
  

• 创建测试用例：右键测试套件 → New Test Case，编写具体测试步骤。
  

2. 编写测试用例示例

*** Settings ***
Library SeleniumLibrary

*** Test Cases ***
Baidu Search Test
Open Browser https://www.baidu.com Chrome
Input Text id=kw Robot Framework
Click Button id=su
Sleep 2
Close Browser

3. 执行测试
方式一：点击 RIDE 工具栏绿色运行按钮。
方式二：命令行执行（支持批量运行）：
robot --outputdir ./results 测试套件路径

4 核心概念与进阶技巧

1. 关键字驱动开发

• 内置关键字：如 Log（输出日志）、Should Contain（断言）。
• 自定义关键字：在 *** Keywords *** 区域封装可复用逻辑：
  *** Keywords ***
  Login To System
  [Arguments] ${username} ${password}
  Input Text id=username ${username}
  Input Text id=password ${password}
  Click Button id=login

2. 变量与数据驱动
变量类型：
标量变量：${变量名}（如 ${URL} = https://www.baidu.com）
列表变量：@{变量名}（如 @{USER_LIST} = user1 user2 user3）
字典变量：&{变量名}（如 &{USER} = username=admin password=123）
数据驱动测试：通过 CSV/Excel 驱动多组测试数据：
*** Test Cases ***
Data-Driven Login
[Template] Login To System
admin 123456
user pass
test test123

3. 标签与分类执行
添加标签：在测试用例或套件设置中添加 [Tags] smoke。
选择性执行：
robot --include smoke 测试套件路径 # 仅运行含smoke标签的用例
robot --exclude flaky 测试套件路径 # 跳过含flaky标签的用例

5 常见问题解决方案

1. RIDE 启动失败或闪退
错误现象：Wrong wxPython version 或启动后立即关闭。
解决方法：
修改 RIDE 配置文件：
找到 testrunnerplugin.py（路径如 C:\Python39\Lib\site-packages\robotide\contrib\testrunner）。
将 latin1 改为 mbcs（第 565 行附近）。
确保 WxPython 版本兼容（如 Python 3.7 需 WxPython 4.0.4）。
2. 浏览器驱动未找到
错误现象：WebDriverException: Message: 'chromedriver' executable needs to be in PATH。
解决方法：
下载与浏览器版本匹配的驱动（如 ChromeDriver）。
将驱动文件放入 Python 安装目录（如 C:\Python39）或系统 PATH 路径。
3. 依赖冲突
场景：安装库时提示版本不兼容。
解决方法：
pip install 库名==指定版本 # 例如 pip install robotframework==3.1.2

6 学习资源推荐

官方文档：Robot Framework User Guide
实战教程：CSDN博客《RobotFramework自动化测试框架快速入门》
案例代码：GitHub 搜索 robotframework-examples 获取开源项目。