如何修复Python ahk模块抛出的‘Unexpected data received.’错误？

问题分析 #

你遇到的AHKProtocolError: Unexpected data received异常，核心原因是Python的ahk库与AutoHotkey v2的协议不兼容，或是重装ahk包后缺失了v2相关的依赖支持。

解决方案 #

1. 安装支持AHK v2的ahk包版本 #

卸载现有ahk包后，安装包含v2支持的版本：

pip uninstall -y ahk
pip install ahk[autohotkey-v2]

2. 修正AHK初始化参数 #

确保指定AHK版本为v2，同时核对exe路径的准确性（Windows文件名大小写不敏感，但尽量与实际文件名一致）：

from ahk import AHK

# 注意exe文件名通常是AutoHotkey.exe（小写k），根据实际安装路径调整
ahk = AHK(executable_path=r"C:\Program Files\AutoHotkey\v2\AutoHotkey.exe", version='v2')

3. 排查AHK v2本身的问题 #

• 手动运行C:\Program Files\AutoHotkey\v2\AutoHotkey.exe，确认程序能正常启动，无报错弹窗
• 若AHK v2启动异常，建议重新下载安装官方最新版的AutoHotkey v2

4. 降级到AHK v1测试（可选） #

如果不需要v2特性，可切换到AHK v1：

from ahk import AHK

# 替换为AHK v1的安装路径
ahk = AHK(executable_path=r"C:\Program Files\AutoHotkey\AutoHotkey.exe")

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