写 AHK 脚本的人迟早会撞上这个问题:脚本发到 30 台电脑上,改一个热键就得挨个跑一遍,或者发个压缩包让同事自己解压——然后总有人用的是旧版。
这篇讲怎么让脚本自己更新自己:启动时检查版本,有新版本就下载、校验、替换,失败还能回滚。整套逻辑不超过 60 行。
一、整体思路
脚本启动
↓
读取本地 version.txt
↓
请求服务器上的 latest.json(含版本号 + 下载地址 + 哈希)
↓
版本相同 → 直接运行
版本更新 → 下载新文件到临时目录 → 校验哈希 → 替换 → 重启
关键点:不能直接覆盖正在运行的脚本(文件被占用),必须用一个外部进程延迟替换。
二、服务器上放什么
一个静态 JSON 就行,放自己网站或对象存储:
{
"version": "1.3.2",
"url": "https://example.com/updates/tool-1.3.2.ahk",
"sha256": "9f2c1a...",
"notes": "修复了高 DPI 下坐标偏移"
}
三、客户端脚本
#Requires AutoHotkey v2.0
; ── 配置 ──
UPDATE_URL := "https://example.com/updates/latest.json"
LOCAL_VER := "1.3.0"
SELF := A_ScriptFullPath
CheckUpdate()
CheckUpdate() {
global UPDATE_URL, LOCAL_VER, SELF
try {
req := ComObject("WinHttp.WinHttpRequest.5.1")
req.Open("GET", UPDATE_URL, false)
req.SetTimeouts(3000, 3000, 5000, 5000)
req.Send()
if (req.Status != 200)
return
info := ParseJson(req.ResponseText)
} catch {
return ; 网络不通就安静跳过,不要打扰用户
}
if !info.Has("version") || VerCompare(info["version"], LOCAL_VER) nul`r`n"
. 'copy /y "' tmp '" "' SELF '"`r`n'
. 'start "" "' SELF '"`r`n'
. "del `"%~f0`"`r`n"
FileAppend script, cmd, "UTF-8"
Run cmd, , "Hide"
ExitApp
}
GetSHA256(path) {
; 用 PowerShell 算哈希,避免自己实现
cmd := 'powershell -NoProfile -Command "(Get-FileHash -Algorithm SHA256 -Path `"' path '`").Hash.ToLower()"'
out := ""
try {
shell := ComObject("WScript.Shell")
ex := shell.Exec(A_ComSpec ' /c ' cmd)
out := Trim(ex.StdOut.ReadAll())
}
return out
}
; 极简 JSON 解析(只处理扁平对象)
ParseJson(s) {
m := Map()
RegExMatch(s, '"version"s*:s*"([^"]+)"', &v) ? m["version"] := v[1] : 0
RegExMatch(s, '"url"s*:s*"([^"]+)"', &u) ? m["url"] := u[1] : 0
RegExMatch(s, '"sha256"s*:s*"([^"]+)"', &h) ? m["sha256"] := h[1] : 0
return m
}
四、为什么用批处理替换
Windows 会锁住正在运行的 .ahk 文件(尤其是被 AutoHotkey.exe 关联执行时),脚本自己删不掉自己。所以走这条路:
- 写一个 bat,先
ping等 2 秒(给主进程退出的时间) - 用
copy /y覆盖旧文件 start重新拉起来- bat 自己删掉自己
五、失败回滚
更新最怕”换上去跑不起来”。上线前留一份旧版:
; 替换前先备份
FileCopy SELF, SELF ".bak", 1
; 新版本启动时做健康检查:如果 30 秒内没写"启动成功"标记,就回滚
if FileExist(A_ScriptDir "boot_ok.flag")
FileDelete A_ScriptDir "boot_ok.flag"
else if FileExist(SELF ".bak") {
MsgBox "上次更新后启动失败,正在回滚"
FileCopy SELF ".bak", SELF, 1
ExitApp
}
SetTimer MarkAlive, -30000
MarkAlive() => FileAppend("ok", A_ScriptDir "boot_ok.flag")
六、踩过的坑
- 文件被占用:一定要用外部进程替换,别指望脚本自己覆盖自己
- 杀软拦截:bat 里
copy+start容易被判为可疑行为,建议整个目录加白名单 - 网络失败:更新检查必须 try/catch 且静默失败,否则断网时脚本直接不能用
- 半截文件:必须校验哈希,WiFi 断了会下到 0 字节文件
- 权限:装在 Program Files 下的脚本普通用户没写权限,更新会失败,装到 AppData 更省心
- 多版本并存:更新后旧进程可能还活着,检查一下进程名再启动
七、再往前一步:加压授权码
自更新的下一步是”谁能用”。把 latest.json 换成带签名的接口,客户端带上用户授权码去换下载地址——没授权码拿不到新版本,这就是一套最朴素的商业授权机制。进一步的做法是把关键逻辑放服务端,客户端只做展示。
如果你正在把脚本发给同事或客户,这套机制能省掉 90% 的”帮我更新一下”。配套的脚本模板、异常处理、打包清单都整理在 AI 自动化工具包 里。

