Robot Framework编写FOR循环时${i}提示变量定义未找到错误

在Robot Framework测试用例文件中编写列表遍历逻辑时，循环变量${i}触发「Variable definition not found（变量定义未找到）」报错，问题代码如下：

@{List1}=    Create List    a    b    c    f
FOR    ${i}    IN    @{List1}
    Log    ${i}
END

代码预期逻辑为创建包含a、b、c、f四个元素的列表@{List1}，通过FOR循环遍历列表内所有元素并打印日志，实际执行时循环变量被识别为未定义。

该报错属于Robot Framework循环语法适配问题，常见触发原因有三类：

• 核心原因：本地安装的Robot Framework版本低于4.0。FOR/END形式的块级循环语法是Robot Framework 4.0版本才正式上线的新特性，3.x及更早版本不识别该语法格式，无法解析出FOR行声明的${i}是循环局部变量，直接判定为未定义变量。
• 次要原因：本地Robot Framework版本已经是4.0及以上，但编辑器搭载的Robot语法检测插件版本过旧，静态检查规则未适配新循环语法，触发误报。这类误报不会影响用例实际执行，仅在编辑器内显示错误提示。
• 书写错误：FOR、IN、END三个循环关键字没有全大写书写，Robot Framework对内置关键字大小写敏感，小写书写会导致解析器无法识别循环结构，触发同类变量报错。

根据实际触发原因对应处理即可：

• 针对版本过低问题
  • 优先方案：升级Robot Framework到4.0及以上稳定版本，执行命令pip install --upgrade robotframework，升级完成后原有代码可直接正常运行。
  • 兼容方案：如果项目依赖要求必须使用3.x旧版本，将循环语法修改为旧版兼容格式即可。旧版语法要求循环行以:FOR开头，循环内每行代码前必须加反斜杠标记，无需单独写END结束符，兼容代码如下：

    @{List1}=    Create List    a    b    c    f
    :FOR    ${i}    IN    @{List1}
    \    Log    ${i}
    

• 针对插件误报问题：直接升级所用编辑器对应的Robot语法支持插件（如VS Code的Robot Framework Language Server、原生RIDE编辑器）到最新版本，重启编辑器后静态检查误报就会消失。
• 针对书写错误问题：将FOR、IN、END三个关键字修改为全大写格式，保证语法符合解析规则。

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