用 AutoHotkey v2 写一个带界面的小工具:布局、事件、托盘、设置保存(附完整可运行示例)

从最小可用界面到进度条、托盘、设置保存与打包,把 AHK 脚本变成能交给别人用的小工具,附完整可运行代码。

很多人写 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 自动化工具包 里。

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

给TA捐赠
共{{data.count}}人
人已捐赠
AI 自动化

AutoHotkey v2 批量处理文件:重命名、按类型归类、重复文件去重、批量改内容(附可撤销方案)

2026-11-16 1:02:34

AI 自动化

AutoHotkey v2 批量处理 Word 与 Outlook:模板生成合同、批量转 PDF、自动发邮件(附代码)

2026-11-16 1:22:35

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
❯
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索