AHK_H v1 是 AutoHotkey v1 的增强分支，适合想研究多线程、AutoHotkey.dll、内存运行、资源打包、WinAPI 简化调用的用户。它很强，但不建议新手一上来就把它当成“普通 v1 的无脑优化版”。
先看文档入口：AHK_H v1 帮助文档。这篇文章按新手最容易踩的 10 个坑来讲，先把边界感建立起来。
一、以为 H 版会让普通脚本自动变强+性能优化
大多数普通 AHK v1 脚本，在 H 版下仍然只是普通脚本。H 版新增的是工具箱，不是自动性能优化版。热键、Send、WinWait、COM、文件读写这些基础能力，仍然要按 v1 的稳定写法来写。
#Requires AutoHotkey v1.1
#NoEnv
#SingleInstance Force
SetWorkingDir, %A_ScriptDir%
^!t::
MsgBox, 普通 v1 脚本在 H 版里仍然按 v1 思路运行
return
所以第一步不是马上用多线程，而是先确认原脚本在普通 v1 下已经稳定，对普通 v1 源代码的兼容性99%。
二、没分清进程、线程和脚本上下文
AHK_H 的 AhkThread 可以用 AutoHotkey.dll 在当前进程中创建新的 AHK 线程。它不是简单的 Gosub，也不是普通 SetTimer。不用AutoHotkey.dll，也可以用多线程解释器直接调用 AhkThread 来实现多线程。
新线程有自己的脚本上下文、变量和执行状态。你不能默认主脚本里的变量在子线程里直接可用。
三、以为多线程可以随便共享变量
多线程共享数据要非常小心。文档里的 Alias 可以把变量作为别名共享给其它线程，但这也意味着你要考虑读写时机。
; 思路示例：共享变量不是普通全局变量那么简单 var := "Hello" Alias(sharedVar, var) sharedVar := "AHK_H" MsgBox, % var
只要涉及多个线程同时读写，就要考虑临界区、锁、对象共享方式。简单脚本不要为了“高级”而强行多线程。
四、忘记释放 AhkThread 资源
AhkThread 创建出来的线程对象，用完后要终止和释放。文档示例里会调用 ahkthread_free(obj) 并把对象置空。否则长期运行的工具可能留下资源占用或状态残留。
五、把 DynaRun 当成多进程
DynaRun 是动态运行代码到新的 AutoHotkey 进程，它返回的是新进程 PID。它和 AhkThread 不同，一个是新进程，一个是当前进程内的新 AHK 线程。
pid := DynaRun("MsgBox, 这是新进程里的脚本", "MyDynaRunScript")
MsgBox, % "新进程 PID：" pid
如果你只是想临时跑一段独立脚本，DynaRun 很方便；如果你要在同一进程里共享对象和状态，就不是同一个问题了。
六、看到 WinApi 就不学 DllCall
AHK_H 的 WinApi 可以把很多 Windows API 当作函数调用，看起来比 DllCall 轻松。但参数类型、返回值、指针、Unicode/ANSI 这些基础仍然要懂。
WinApi 是减少重复写法，不是免除 Windows API 基础知识。
七、编译时还用普通 v1 的思维
AHK_H 文档提到，它可以编译不同的 AutoHotkey 二进制，包括 AutoHotkey.dll、AutoHotkey.exe、AutoHotkeySC.bin，并且 Ahk2Exe 有 H 版功能。迁移到 H 版后，编译环境和运行环境要一起确认，不要只换解释器。
八、没注意窗口类名被改过
H 版有 #WindowClassMain 和 #WindowClassGui，可以修改主窗口和 GUI 窗口类名。如果你的脚本或其它脚本靠 ahk_class AutoHotkey、ahk_class AutoHotkeyGUI 定位窗口，改类名后就会影响互相控制。
九、把 H 版专用语法写进普通 v1 项目
H 版命令如 AhkThread、DynaRun、WinApi、Struct、CriticalObject 等，不一定能在普通 v1 解释器里运行。共享脚本给别人时，要说明需要 AHK_H v1。
十、从底层功能开始学，反而忘了业务目标
AHK_H 很容易让人沉迷底层能力：线程、内存模块、资源、机器码、DLL。可是对多数自动化任务来说，稳定窗口、控件、COM、文件和日志仍然更重要。
结语
AHK_H v1 的正确入门方式是：先把普通 v1 脚本写稳，再按需求引入 H 版能力。需要多线程时看 AhkThread 和 AutoHotkey.dll，需要动态运行时看 DynaRun，需要 API 简化时看 WinApi 和 #DllImport。不要反过来，为了用 H 版功能而把简单脚本写复杂。
评论(0)