Qt 工程瘦身工具：批量删除 build 目录与 IDE 配置文件

目录一、创作动机二、脚本的作用三、脚本做了什么详细说明3.1 环境准备3.2 扫描与统计3.3 清理当前目录3.4 遍历子目录清理3.5 统计报告四、脚本代码五、逻辑流程六、使用方法七、下载一、创作动机作为一名 Qt/QML 开发者你一定遇到过这样的情况辛辛苦苦写了数十个示例工程目录结构整整齐齐某天想把这些工程打包发出去或者备份到网盘时却发现压缩包大得离谱。仔细一看原来每个工程目录下都残留着build文件夹、CMakeLists.txt.user文件等编译产物。一个小工程可能只有几百 KB 的源码但编译后动辄几十 MB几十个工程加起来就是好几个 GB。如果一开始就做好了统一的编译输出管理比如设置CMAKE_BINARY_DIR指向外部目录自然不会遇到这个问题。但现实往往是项目太多了前期没有规范后期已经来不及逐个修改了。这时候你有几个选择手动删除—— 几十个目录挨个进去删枯燥且容易遗漏。交给 AI 写脚本—— AI 生成的代码不一定可靠万一误删了源码就麻烦了。自己写一个固定的脚本—— 一劳永逸。脚本逻辑确定、行为可控以后每次打包前双击运行即可。这个脚本正是为第三种场景而生的。二、脚本的作用一句话概括递归清除当前目录下所有 Qt/QML 工程的编译产物不动源码一根汗毛。具体清理的目标文件/文件夹目标类型说明build/目录CMake 默认的构建输出目录包含所有 .o、.exe、.a 等编译产物CMakeLists.txt.user文件Qt Creator 的工程配置文件记录了编译选项、断点等 IDE 信息这两个东西是 Qt/QML 工程中最常见的垃圾文件。build目录是体积大户一个 Release 构建动辄几十上百 MB.user文件则因人而异提交到 Git 仓库时通常也会被.gitignore忽略。脚本只会删除上述两类目标其他所有文件 ——.cpp、.qml、.h、CMakeLists.txt、资源文件、图片、文档等 —— 全部原封不动。三、脚本做了什么详细说明脚本的实际行为可以拆解为以下几个层面3.1 环境准备设置UTF-8编码chcp 65001确保中文路径和提示信息正常显示。切换到脚本自身所在的目录cd /d %~dp0无论从哪里双击运行都只清理脚本所在目录下的内容。启用延迟变量扩展EnableDelayedExpansion确保循环中变量值正确更新。3.2 扫描与统计先遍历一级子目录统计工程总数显示进度条时使用。设置三个计数器count已删除数量、errors失败数量、current当前处理序号。3.3 清理当前目录当前目录下如果存在build文件夹删除。当前目录下如果存在CMakeLists.txt.user文件删除。这一步处理的是脚本直接所在目录的情况比如脚本放在所有工程的根目录而根目录本身也是一个 Qt 工程。3.4 遍历子目录清理遍历所有一级子目录对每个目录执行相同的清理逻辑删除子目录/build文件夹删除子目录/CMakeLists.txt.user文件每一步都有成功/失败的状态反馈。3.5 统计报告输出清理统计总工程数、成功删除数、失败数。如果有删除失败的情况通常是权限不足或被其他进程占用给出明确的警告提示。四、脚本代码echo off setlocal EnableDelayedExpansion chcp 65001 nul cd /d %~dp0 echo echo Qt Project Cleanup Tool echo echo Base Directory: %cd% pause echo Start Time: %date% %time% echo. set count0 set errors0 set total_dirs0 set current0 REM Count total directories first for /d %%p in (*) do ( set /a total_dirs1 ) echo Found %total_dirs% project directories echo. echo ---------------------------------------- echo Starting cleanup... echo. REM Clean current directory first set root_has_items0 echo [ROOT] Processing current directory if exist build ( rd /s /q build 2nul if errorlevel 1 ( echo [FAILED] build set /a errors1 ) else ( echo [DELETED] build set /a count1 set root_has_items1 ) ) if exist CMakeLists.txt.user ( del /f /q CMakeLists.txt.user 2nul if errorlevel 1 ( echo [FAILED] CMakeLists.txt.user set /a errors1 ) else ( echo [DELETED] CMakeLists.txt.user set /a count1 set root_has_items1 ) ) if !root_has_items!0 ( echo [NO ITEMS] ) echo. REM Clean subdirectories for /d %%p in (*) do ( set /a current1 echo [!current!/%total_dirs%] Processing: %%p set has_deleted0 if exist %%p\build ( rd /s /q %%p\build 2nul if errorlevel 1 ( echo [FAILED] %%p\build set /a errors1 ) else ( echo [DELETED] %%p\build set /a count1 set has_deleted1 ) ) if exist %%p\CMakeLists.txt.user ( del /f /q %%p\CMakeLists.txt.user 2nul if errorlevel 1 ( echo [FAILED] %%p\CMakeLists.txt.user set /a errors1 ) else ( echo [DELETED] %%p\CMakeLists.txt.user set /a count1 set has_deleted1 ) ) if !has_deleted!0 ( echo [NO ITEMS] ) echo. ) echo ---------------------------------------- echo Cleanup Complete! echo. echo Statistics echo Total Projects: %total_dirs% echo Deleted: %count% items echo Failed: %errors% items echo End Time: %date% %time% echo echo. if %errors% gtr 0 ( echo [WARNING] %errors% items failed to delete. Check permissions. echo. ) echo Press Enter to exit... pause endlocal五、逻辑流程整个脚本的执行流程如下关键设计决策不递归进入子目录的子目录只处理一级子目录。这是有意为之的因为 Qt 工程通常是一级目录一个工程深层嵌套会大幅增加风险和复杂度。如果确实需要更深层级的清理可以手动调整或运行多次。存在性检查优先于删除先if exist再执行删除避免对不存在的路径误操作。逐条反馈不留盲区每一条删除操作都有明确的状态输出用户随时可以检查日志确认没有误删。失败不中断某个文件/目录删除失败不会中断整个流程而是记录错误数并在最后统一报告。六、使用方法运行效果将cleanup_projects.bat复制到你的 Qt 工程集合的根目录下。双击运行或者从命令行执行。等待脚本执行完毕确认统计信息无误。按 Enter 退出此时编译文件已被清空。个人建议放在所有工程的父目录运行而不是每个工程里放一个。配合.gitignore使用在仓库中忽略build/和*.user文件从根本上避免这类文件被提交。对于未来新建的 Qt 工程建议统一设置CMAKE_BINARY_DIR到外部路径从根源上避免编译产物散落在源码目录中。七、下载脚本下载链接https://gitcode.com/u011186532/qml_demo/blob/main/cleanup_projects.bat无需额外依赖Windows 系统原生支持。本脚本专为 Qt/QML 工程开发适用于 Windows 平台。用于其他类型的 CMake 工程也可能有效但请先确认清理目标是否合适。