有人问怎么下载,我把 Go 批量改名工具开源了
- 2026-11-17 04:59:51
上一篇批量改名工具发出去后,有位朋友在留言里问,能不能连续命名成 00191 到 00202 这种格式。聊了两句,他又问怎么下载。
当时我回复的是,还没开源,后续再整理。
现在把这个坑补上。代码已经放到 GitHub,仓库叫 FileBox,里面的批量改名工具仍叫 RenameLite。源码、使用说明、测试记录都在里面,采用 MIT 协议开源。FileBox 源码仓库
我也放了一份 Windows 可执行文件。想先用起来,可以直接下载发布版,解压后双击 RenameLite.exe。当前提供 Windows amd64 版本。下载发布版
就拿留言里的编号试一遍
假设有 12 个 PNG 文件,想统一改成下面这样。
00191.png 00192.png 00193.png …… 00202.png 打开工具,点击“选择文件夹”,把这批文件所在的目录选进来。当前处理范围是这个文件夹里的普通文件,界面会把参与改名的文件列出来。
这次把“查找文字”“替换为”“添加前缀”“添加后缀”都留空,剩下几个选项这样填。
191 | |
5 位 | |
191 是从哪个数开始,5 位 负责在前面补零。取消保留原主名后,新名字就是编号加上原扩展名。
整理开源版时,我发现一个小地方。后端已经支持更长的编号,界面的下拉框却只放了 2、3、4 位。照着留言里的例子操作,刚好缺了 5 位。
这次把 5~8 位选项补上了。下面这张图,就是用发布版窗口生成的 12 个模拟文件预览。

点“生成改名预览”后,先看右边的原名和新名。上方会显示参与文件、将要修改和名称冲突数量。确认这 12 个文件都对得上,再点“执行改名”,在弹出的确认框里确认。
如果只是给一批资料加上 _备份,也可以关闭连续编号,勾选“保留原文件主名”,在后缀里填 _备份。比如 资料.txt 会变成 资料_备份.txt。
改了规则以后,再生成一次预览。这个习惯保留下来,用起来会踏实一些。
改完了,怎么撤销
执行以后,窗口下面会出现一条“操作记录”,里面有文件夹、时间和文件数量。找到刚才那一批,点击“撤销这批改名”就能尝试恢复原名。
记录会保存在本机。为了确认下载版也能走通,我用正式 exe 把这 12 个文件改完名,关掉应用,再重新打开,从记录里撤销。恢复后又检查了一遍原文件名和每个文件的 SHA-256,全部对上。

撤销前,程序会检查文件身份、大小、修改时间,以及原名有没有被占用。文件已经被编辑、删除、替换,或者原来的名字被其他文件占着时,会停下来给出提示,需要先处理对应问题。
默认记录目录在 %APPDATA%\RenameLite\history。每批操作有一份 .json 清单和一份 .wal 进度文件,两份要一起保留。撤销能恢复名字,文件内容的版本恢复仍需要自己的备份。
当前支持所选文件夹这一层,每个文件夹最多 5000 个目录项。编号按当前文件名排序,使用时先看清预览里的顺序。
下载和源码运行,各准备什么
发布版用到 Windows 的 WebView2 Runtime。遇到缺少运行时的提示,可以从微软页面安装 Evergreen Runtime,再重新打开应用。WebView2 官方下载页
Go、Node.js、npm 和 Wails CLI 是源码开发要准备的工具。想自己改界面或者命名规则,可以在 Windows 上按下面的命令跑。
git clone https://github.com/fengfengzhidao/file_box.git cd file_box go install github.com/wailsapp/wails/v3/cmd/wails3@v3.0.0-beta.19 go mod download npm ci --prefix frontend wails3 build APP_NAME=RenameLite .\bin\RenameLite.exe 这份工程使用 Wails v3.0.0-beta.19,Go 模块、前端 runtime 和 CLI 保持匹配。安装命令也固定到这个版本,方便按当前代码复现。Wails Beta.19 发布说明
我本次用的是 Windows 11 Build 26200、AMD Ryzen 7 8745H、amd64,Go 1.25.0、Node 24.14.1、npm 11.11.0。正式 exe 是 9.21 MiB,系统 WebView2 单独提供运行环境。
发布前还重新跑了 50 个和 500 个模拟文件,各三轮预览、执行、重新载入记录和撤销,六轮的原名与内容哈希都恢复了。Go 测试和静态检查也通过,原始结果放在仓库的 measurements.json 和 TEST-RESULTS.md,想复测可以运行 go run ./cmd/measure。
关键代码主要在 internal/rename,文件名怎么生成、冲突怎么检查、改名和撤销怎么落到磁盘,都在这里。界面放在 frontend/src/App.vue。想调整规则,可以从这两处看起。
后面更想补这几个地方
我现在最想先改的是排序。当前按文件名排序,像 1.png、10.png、2.png 这种名字,编号顺序就需要格外看一眼。加上自然排序,让数字按 1、2、10 排,再让用户选择排序方式,会更贴近整理素材的习惯。
另一个是选择参与文件。现在选择文件夹以后,会把当前层级可处理的文件一起列出来。我想加按扩展名筛选和逐个勾选,比如同一目录里只处理 PNG,或者临时排除其中几张,预览里就能看清这次到底动哪些文件。
还有规则预设。前缀、补零位数、是否保留主名这些设置,用顺手以后往往会重复。把常用规则保存下来,下次选好文件夹,再调整起始编号就够了。
这几个方向已经记到仓库 README,具体先补哪个,再看大家真正卡在哪一步。如果有一组文件名总要手工处理,可以把脱敏后的原名和期望新名放到 Issue 里。能把例子摆出来,下一步要解决什么就清楚多了。提交使用反馈