Robot Framework测试套件结构及使用问题咨询

一、测试套件的核心运作逻辑 #

Robot Framework的测试套件由目录和**.robot测试用例文件**共同构成层级结构：

• 每个目录自动成为一个测试套件，目录名就是套件名（会自动转成首字母大写格式，比如test1变成Test1）
• 每个.robot文件也是一个测试套件，文件名就是套件名
• 测试用例直接写在.robot文件的*** Test Cases ***区块中，不存在单独的"TestSuite文件"

你拆分数百个用例到不同组/文件的思路是正确的，比如你给出的目录结构：

tests/test1/test.robot
     /test2/test.robot
     /test3/test.robot

这里tests是根套件，test1、test2、test3是它的子套件，每个子套件下的test.robot存放对应组的测试用例。

二、执行命令报错的原因 #

你执行robot --suite ./tests时出错，核心原因有两个：

1. --suite参数用法错误：该参数需要指定套件名称（比如Tests、Test1），而非文件/目录路径。正确执行根套件的方式是：

   robot tests/
   

   若要指定某个子套件，用名称而非路径：

   robot --suite Test1 tests/
   

2. 资源文件被误识别为套件：报错信息提到tests/test.resource，说明你的tests目录下存在.resource资源文件。Robot会扫描目录下的相关文件，.resource文件会被当作套件，但它仅存放关键字，没有测试用例，因此抛出"contains no tests"错误。

解决方法：

• 将资源文件移到单独目录（比如resources/），与测试用例目录分离
• 执行时指定只运行.robot文件：

  robot --extension robot tests/
  

三、目录套件的配置方法 #

如果需要给目录级套件（比如tests根套件）添加统一配置（如前置/后置操作、变量、资源导入），可在目录下创建__init__.robot文件，这就是目录套件的配置文件，语法与普通.robot文件一致，示例：

*** Settings ***
Documentation    根测试套件：所有业务场景集合
Suite Setup      全局初始化环境
Suite Teardown   全局清理环境
Variables        ../config/global_vars.py
Resource         ../resources/common_keywords.resource

该文件可包含Settings、Variables、Keywords等区块，无需Test Cases区块，作用是给整个目录套件提供统一配置。

四、测试用例的正确存放方式 #

测试用例必须写在.robot文件的*** Test Cases ***区块中，示例：

*** Settings ***
Documentation    Test1子套件：用户登录相关测试
Resource         ../../resources/login_keywords.resource

*** Test Cases ***
正常登录验证
    [Documentation]    验证合法账号登录成功
    输入用户名    test_user
    输入密码    test_pass
    点击登录按钮
    验证页面跳转至    首页

异常登录验证-密码错误
    [Documentation]    验证密码错误时的提示
    输入用户名    test_user
    输入密码    wrong_pass
    点击登录按钮
    验证提示信息包含    密码错误

内容的提问来源于stack exchange，提问作者Coliban