Katalon Studio自定义关键字检测机制及导入范围确认

结论：是的，Katalon Studio仅从指定位置导入自定义关键字 #

你观察到的现象完全符合Katalon Studio的内置规则：只有/Keywords目录下的Groovy/Java类，以及项目中引入的外部.jar库，会被Katalon自动扫描识别带有@Keyword注解的方法，并将这些关键字整合到Libs/CustomKeywords.groovy文件中。

背后的机制 #

这是Katalon Studio约定式的关键字管理逻辑：

• Keywords目录是官方明确指定的自定义关键字专属存放位置，项目启动、刷新或修改关键字类时，Katalon会递归扫描该目录下的所有类，自动解析@Keyword注解，生成CustomKeywords中的调用代理方法。
• 而/Include这类目录的设计定位是存放辅助脚本、配置文件、通用工具类等非关键字逻辑，Katalon的扫描器不会在这里查找@Keyword注解，因此这类目录下的带注解方法不会被识别为可调用的自定义关键字。

额外实践建议 #

如果希望复用/Include目录下的逻辑但又不想移动文件到/Keywords，可以采用以下方式：

1. 将/Include中的类封装为通用工具类（无需添加@Keyword注解）
2. 在/Keywords目录下创建新的关键字类，在其中调用工具类的方法，并给这个调用方法添加@Keyword注解

这样既可以保持原有目录结构的合理性，又能让需要的逻辑成为可调用的自定义关键字。

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