有些流程天生是”事件驱动”的:文件一落地就要处理——下载完的报表要归档、收到的图纸要转格式、导出的大图要压缩。
这篇讲怎么用 AutoHotkey 稳稳地做这件事,重点在三个容易被忽略的细节:防抖、去重、失败重试。
一、为什么用轮询而不是系统通知
Windows 有 ReadDirectoryChangesW 这种系统级通知,但要 DllCall 一堆结构体,还容易漏事件(缓冲区溢出时)。
对”几十秒内处理就行”的场景,轮询更简单可靠:
#Requires AutoHotkey v2.0
#SingleInstance Force
WATCH_DIR := A_Desktop "待处理"
DONE_DIR := A_Desktop "已处理"
INTERVAL := 3000 ; 3 秒扫一次
DirCreate WATCH_DIR
DirCreate DONE_DIR
SetTimer(Scan, INTERVAL)
Scan() {
global WATCH_DIR, DONE_DIR
Loop Files, WATCH_DIR "*.*", "F"
{
path := A_LoopFileFullPath
if !IsReady(path)
continue ; 还在写入,下次再说
if IsDone(path)
continue ; 已经处理过
Process(path)
}
}
3000ms 对你来说是”立刻”,对 CPU 来说是几乎零成本(一次目录遍历而已)。
二、防抖:判断”文件写完了没有”
这是最容易翻车的地方。文件刚被创建时大小是 0,或者还在增长,这时候处理必然出错。
; 连续两次读到的大小一样,才认为写完了
IsReady(path, waitMs := 800) {
try {
s1 := FileGetSize(path)
if (s1 = 0)
return false ; 空文件先跳过
Sleep waitMs
s2 := FileGetSize(path)
return (s1 = s2)
} catch {
return false ; 文件可能被占用/已删除
}
}
更稳的写法:用独占方式尝试打开,打不开说明还被占用。
IsLocked(path) {
try {
f := FileOpen(path, "a")
f.Close()
return false
} catch {
return true
}
}
三、去重:防止同一个文件被处理两次
轮询的天敌是”处理完但没移走”——下一次扫描又来了。两种解法:
解法 A:处理完移走(简单可靠)
Process(path) {
global DONE_DIR
SplitPath path, &name
; ...实际处理...
FileMove path, DONE_DIR "" name, 1
Log("处理完成:" name)
}
解法 B:记录已处理清单(需要原地保留文件时)
SEEN_FILE := A_AppData "AutoAHKwatcher_seen.txt"
IsDone(path) {
global SEEN_FILE
key := path "|" FileGetSize(path) "|" FileGetTime(path, "M")
if !FileExist(SEEN_FILE)
return false
content := FileRead(SEEN_FILE, "UTF-8")
return InStr(content, key) > 0
}
MarkDone(path) {
global SEEN_FILE
key := path "|" FileGetSize(path) "|" FileGetTime(path, "M")
FileAppend key "`n", SEEN_FILE, "UTF-8"
}
用「路径+大小+修改时间」做键,同名但被改过的文件会重新处理。
四、失败重试:别让一次异常卡死整个流程
Process(path, retries := 3) {
global DONE_DIR
SplitPath path, &name
Loop retries {
try {
DoWork(path) ; 你的实际处理逻辑
FileMove path, DONE_DIR "" name, 1
Log("[OK] " name)
return true
} catch as e {
Log("[ERR] 第 " A_Index " 次:" name " → " e.Message)
Sleep 1000 * A_Index ; 递增等待
}
}
; 三次都失败,移到失败目录,别反复重试
failDir := A_Desktop "处理失败"
DirCreate failDir
try FileMove path, failDir "" name, 1
return false
}
关键:失败的文件必须移走,否则每 3 秒重试一次,日志会被刷爆。
五、日志:至少要能回答”这个文件处理了吗”
Log(msg) {
static LOG := A_AppData "AutoAHKwatcher.log"
DirCreate A_AppData "AutoAHK"
FileAppend FormatTime(, "yyyy-MM-dd HH:mm:ss") " " msg "`n", LOG, "UTF-8"
}
日志按行追加,出问题时可以看到完整的处理时间线。
六、三个实战场景
场景 1:下载文件夹自动归档
; 按扩展名分流
DoWork(path) {
SplitPath path, &name, , &ext
ext := StrLower(ext)
target := (ext ~= "^(xls|xlsx|csv)$") ? "表格"
: (ext ~= "^(jpg|png|webp)$") ? "图片"
: (ext ~= "^(pdf|docx)$") ? "文档"
: "其它"
dest := A_Desktop "归档" target
DirCreate dest
FileMove path, dest "" name "." ext, 1
}
场景 2:大图自动压缩
DoWork(path) {
SplitPath path, &name, &dir, &ext
if !RegExMatch(StrLower(ext), "^(jpg|jpeg|png)$")
throw Error("不是图片")
; 调用之前写过的 GDI+ 压缩函数(见「批量处理图片」那篇)
ResizeImage(path, dir "out_" name "." ext, 1600, 82)
}
场景 3:收到图纸自动转 PDF 并上传
DoWork(path) {
SplitPath path, &name, , &ext
if (StrLower(ext) != "docx")
throw Error("只处理 docx")
; Word 转 PDF(见「批量处理 Word」那篇)
; 上传到服务器(见「网络能力」那篇)
}
七、六个坑
- 临时文件:Office 保存时会先写
~$xxx.docx,要过滤掉以~$开头的文件 - 大文件传输慢:防抖的 800ms 不够,改成”大小连续 3 次不变”更稳
- 网络盘:SMB 共享上的文件状态可能滞后,判断要更保守
- 文件被占用:用独占打开探测,别指望文件大小判断
- 循环误触发:如果把处理结果写回监控目录,会无限循环——输出目录必须在监控范围外
- 长时间运行:记得加
#SingleInstance Force,否则重复启动会有多个监控器抢同一个文件
八、什么时候不用轮询
- 需要毫秒级响应 → 用
ReadDirectoryChangesW - 文件量极大(每秒几十个)→ 用专门的守护进程或 Python watchdog
- 跨机器同步 → 用 Syncthing / rsync 触发
日常的”文件夹来了文件就处理”,轮询完全够用,而且好调试。
这套监控如果需要做成带界面的工具(显示处理队列、手动重试、暂停监控),AI 自动化工具包里有完整实现;企业侧要做无人值守的文件流水线,可以留个联系方式聊。

