很多人写 AHK 脚本卡在同一个地方:功能会写了,但没法交给别人用——因为对方不会改代码、不会看提示。
加个界面,脚本就从”自己的工具”变成”能给别人用的软件”。这篇从零做一个完整的小工具:输入框、按钮、进度条、托盘菜单、设置自动保存。
一、最小可用界面(20 行)
#Requires AutoHotkey v2.0
g := Gui("+Resize", "批量重命名工具")
g.SetFont("s10", "Microsoft YaHei UI")
g.AddText("w420", "选择文件夹后,把文件名里的空格替换成下划线")
g.AddEdit("vFolder w320")
g.AddButton("x+8 yp w80", "浏览").OnEvent("Click", PickFolder)
g.AddButton("xm w120 h32 Default", "开始处理").OnEvent("Click", Run)
g.AddButton("x+10 w100 h32", "退出").OnEvent("Click", (*) => ExitApp())
log := g.AddEdit("xm w420 h120 ReadOnly -Wrap +VScroll")
g.Show("w440 h300")
PickFolder(*) {
global g
p := DirSelect(, 3, "选择要处理的文件夹")
if p != ""
g["Folder"].Value := p
}
Run(*) {
global g, log
dir := Trim(g["Folder"].Value)
if dir = "" {
MsgBox "请先选择文件夹"
return
}
if !DirExist(dir) {
MsgBox "文件夹不存在"
return
}
n := 0
Loop Files, dir "*.*", "F" {
SplitPath A_LoopFileFullPath, &name, &d, &ext
if !InStr(name, " ")
continue
newPath := d "" StrReplace(name, " ", "_") "." ext
if FileExist(newPath)
continue
FileMove A_LoopFileFullPath, newPath
log.Value .= name "." ext " → " StrReplace(name, " ", "_") "." ext "`r`n"
n++
}
MsgBox "完成,处理了 " n " 个文件"
}
几个关键点:
vFolder是控件名,之后用g["Folder"]取值/赋值xm= 换行对齐到左边距;x+8= 紧跟前一个控件右侧 8px(*) =>是 v2 的简写,表示”不关心参数”的回调Default让按钮响应回车
二、布局:别用绝对坐标
手动算 x/y 在控件多的时候会疯。两种省事做法:
做法 1:用列对齐
g.AddText("xm", "输入源文件夹:")
g.AddEdit("xm w420")
g.AddText("xm", "输出文件夹:")
g.AddEdit("xm w420")
g.AddButton("xm w100 h32", "开始")
g.AddButton("x+10 w100 h32", "取消")
做法 2:动态调整大小时重排
g.OnEvent("Size", Resize)
Resize(g, minMax, w, h) {
if (minMax = -1) ; 最小化
return
log := g["Log"]
log.Move(, , w - 40, h - 200) ; 让日志区跟随窗口
}
三、进度条:别让界面假死
循环里直接跑几百个文件,界面会卡住不重绘。加两行就行:
pb := g.AddProgress("xm w420 h18 Range0-100")
...
total := 0
Loop Files, dir "*.*", "F"
total++
i := 0
Loop Files, dir "*.*", "F" {
i++
; ...处理...
pb.Value := i * 100 // total
if (Mod(i, 20) = 0)
Sleep 1 ; 让出时间片,界面才会刷新
}
四、记住上次的选择(别每次重选)
INI := A_ScriptDir "settings.ini"
LoadSettings() {
global g
try {
g["Folder"].Value := IniRead(INI, "main", "folder", "")
}
}
SaveSettings() {
global g
try IniWrite(g["Folder"].Value, INI, "main", "folder")
}
在 Run 里调用 SaveSettings(),启动时调用 LoadSettings()。
五、托盘菜单(关掉窗口不退出)
A_Tray := A_TrayMenu
A_TrayMenu.Delete() ; 清掉默认项,避免菜单太乱
A_TrayMenu.Add("显示主窗口", ShowMain)
A_TrayMenu.Add("退出", (*) => ExitApp())
g.OnEvent("Close", (*) => g.Hide()) ; 点 X 只是隐藏
ShowMain(*) {
global g
g.Show()
WinActivate "ahk_id " g.Hwnd
}
六、让界面在放大缩小时不乱
- 窗口加
+Resize,并处理Size事件 - 给关键控件设最小尺寸,别让窗口缩到看不见
- 字体用
Microsoft YaHei UI,中文显示比默认宋体好很多 - 高分屏下加
DllCall("SetProcessDPIAware")(坐标不糊的常见修法)
七、打包给别人用
Ahk2Exe.exe /in 工具.ahk /out 工具.exe /icon app.ico /compress 1
三个注意:
- 别在代码里写死绝对路径,用
A_ScriptDir - 配置文件放
A_ScriptDir或A_AppData,别放 Program Files(没写权限) - 编译后先用 Windows Defender 扫一遍,误报要提前处理
八、一个常见错误:全局变量忘了声明
; 错误
Run(*) {
g["Folder"].Value := "x" ; g 未定义
}
; 正确
Run(*) {
global g
g["Folder"].Value := "x"
}
v2 要求在函数里显式 global,这是从 v1 迁移过来最容易踩的坑。
小结:界面的价值不在好看,在”别人能用”
同样是批量重命名,命令行脚本只能你自己用;带界面 + 记住设置 + 进度条 + 托盘常驻,就能发给同事、甚至当小软件卖。
如果你想把界面做得更完整(多标签页、拖拽文件、日志持久化、自动更新),这些模板都放在 AI 自动化工具包 里。

