问机器人框架中的多行注释

EN

没有块注释功能。然而，有一个微妙的小技巧，你可以用来评论整个块。它没有被证明是一个多行注释功能，但它可以这样使用。

这个技巧的工作原理是，机器人将忽略表中的任何数据，而这些数据不是四个可识别的表中的一个:关键词、测试、设置或变量。如果您有其他表，它下面的任何内容直到下一个表都会被忽略。

relevant section of the user guide说：

2.1.4解析数据的规则 忽略数据 当机器人框架分析测试数据时，它会忽略：

• 所有不在第一个单元格中以可识别表名开头的表。
• ..。

例如：

*** Test Cases *** 
| test 1 
| | log | this is test one

*** comment ***
| test 2
| | log | this is test two

*** Test Cases ***
| test 3
| | log | this is test three

如果您运行上述测试，您将看到只执行测试1和test3。“注释”表中的所有内容都将被忽略。

理想情况下，如果您想注释一行机器人代码，请将光标放在该行上，然后按ctrl+/，它将从行的开头对该行进行注释。像这样：

#<<Your Code lines here>>

如果您想在该行或关键字前面指定特定的机器人行或关键字，只需键入#并键入您的comment.Like：

Click &{Locator}  #This keyword clicks on the locator specified.

此外，您还可以选择为测试用例编写文档。例如:如果您的测试用例都是关于验证登录积极场景的，那么您可以将文档编写为：

Test case name
    [Tags]  Valid_credentials
    [Documentation]  This test case validates Login functionality with valid credentials.
    Your keywords or variable declaration will start here
    .....
    .....
    finish your test case

希望这个简单的提示能有所帮助。

对于那些想要评论很多行的人来说，另一个窍门是使用ctrl + /。这将注释掉光标所在的行或任何突出显示的行。然后，您可以高亮显示这些行，并再次使用ctrl + /取消注释。