Python无法直接调用SikuliX,但可通过四种方式集成:1. Jython运行.sikuli脚本;2. subprocess调用sikulix.jar执行项目;3. REST API远程控制;4. OpenCV+PyAutoGUI等纯Python替代方案。

Python 本身不能直接调用 SikuliX,因为 SikuliX 是基于 Java 的图形自动化工具(依赖 OpenCV 和 Java AWT),但可以通过以下几种主流方式在 Python 环境中使用 SikuliX 的能力:
1. 使用 Jython 运行 SikuliX 脚本
SikuliX 官方推荐的方式是用 Jython(Python 的 Java 实现)来运行 .sikuli 脚本或调用 SikuliX API。Jython 能直接加载 Java 类,因此可以无缝调用 SikuliX 的 Screen、Region、App 等类。
- 下载并安装 SikuliX(含 Jython 环境)
- 将你的 Python 脚本保存为
.py文件,用 SikuliX 自带的 Jython 解释器执行:sikulix.jar -r your_script.py - 示例代码:
from sikuli import *
screen = Screen()
if screen.exists("login_button.png"):
screen.click("login_button.png")
2. 通过 subprocess 调用 SikuliX IDE 执行 .sikuli 项目
如果你已有 SikuliX IDE 录制好的 xxx.sikuli 文件夹,可用 Python 的 subprocess 模块启动 SikuliX 命令行运行它:
- 确保已安装 SikuliX 并配置好
SIKULIX_HOME环境变量 - 命令格式(Windows 示例):
java -jar sikulix.jar -r "C:\path\to\your.sikuli" - Python 中调用:
import subprocess
subprocess.run([
'java', '-jar', 'sikulix.jar',
'-r', r'C:\myproject\login.sikuli'
])
3. 使用 REST API(SikuliX Server 模式)
SikuliX 支持以服务器模式运行(-s 参数),暴露 HTTP 接口。Python 可通过 requests 发送指令,实现远程控制:
立即学习“Python免费学习笔记(深入)”;
- 启动服务:
java -jar sikulix.jar -s - Python 发起请求(需安装 requests):
import requests
# 检查屏幕是否存在图片
resp = requests.post('http://localhost:50001/exists', json={'pattern': 'ok.png'})
if resp.json().get('exists'):
requests.post('http://localhost:50001/click', json={'pattern': 'ok.png'})
⚠️ 注意:该功能从 SikuliX 2.0.6+ 开始支持,需确保版本兼容且端口未被占用。
4. 替代方案:用纯 Python 库模拟类似功能
如果只是需要图像识别 + 鼠标操作,不强依赖 SikuliX,可考虑更轻量、纯 Python 的组合:











