Windows批处理脚本实现文件夹大小统计与分析

1. 为什么需要统计文件夹大小？

在日常工作中，我们经常需要了解某个文件夹及其子文件夹占用的磁盘空间情况。比如：

• 清理磁盘空间时，需要找出占用空间最大的文件夹
• 项目备份前，想了解项目文件夹的总大小
• 迁移数据时，需要评估传输时间
• 监控系统日志增长情况

Windows资源管理器虽然可以显示文件夹大小，但需要手动右键查看属性，而且无法一次性查看多个文件夹的大小对比。通过批处理脚本，我们可以快速获取这些信息，并且可以自定义输出格式，方便后续处理。

2. 批处理脚本基础准备

2.1 批处理文件基本结构

批处理文件（.bat）是Windows下的脚本文件，由一系列DOS命令组成。一个基本的统计文件夹大小的批处理脚本包含以下部分：

bat复制@echo off
title 文件夹大小统计工具
color 0A

:: 这里是脚本的主要逻辑

pause

• @echo off：关闭命令回显，使输出更简洁
• title：设置命令窗口的标题
• color：设置命令窗口的颜色（0A表示黑底绿字）
• ::：批处理中的注释符号
• pause：执行完毕后暂停，防止窗口立即关闭

2.2 关键命令：dir与for

统计文件夹大小的核心是dir命令和for循环：

bat复制dir /s "文件夹路径"

/s参数表示显示指定目录和所有子目录中的文件。

结合for循环可以提取出我们需要的信息：

bat复制for /f "tokens=3" %%A in ('dir /s "文件夹路径" ^| find "File(s)"') do (
    echo 总大小: %%A
)

3. 完整脚本实现

3.1 基础版本脚本

以下是基础版本的文件夹大小统计脚本：

bat复制@echo off
setlocal enabledelayedexpansion

:: 设置窗口标题和颜色
title 文件夹大小统计工具
color 0A

:: 获取当前目录
set "folder=%~dp0"
echo 正在统计: %folder%

:: 统计文件数量和总大小
for /f "tokens=1,3" %%A in ('dir /a-d /s "%folder%" ^| find "File(s)"') do (
    set "files=%%A"
    set "size=%%B"
)

:: 统计子文件夹数量
for /f "tokens=1" %%A in ('dir /ad /s "%folder%" ^| find "Dir(s)"') do (
    set "dirs=%%A"
)

:: 显示结果
echo.
echo 统计结果:
echo 文件数量: %files%
echo 子文件夹数量: %dirs%
echo 总大小: %size%
echo.
pause

3.2 增强版脚本

基础版本有几个不足：

1. 大小显示不够友好（如显示为"12,345,678"字节）
2. 无法处理包含特殊字符的路径
3. 没有排序功能

以下是增强版脚本：

bat复制@echo off
setlocal enabledelayedexpansion

:: 设置窗口标题和颜色
title 文件夹大小统计工具 - 增强版
color 0A

:: 获取当前目录
set "folder=%~dp0"
echo 正在统计: %folder%
echo.

:: 临时文件路径
set "tempfile=%temp%\~filsize.tmp"

:: 获取文件夹大小函数
call :GetFolderSize "%folder%" size
call :FormatSize !size! formatted_size

:: 统计文件数量和子文件夹数量
for /f "tokens=1,3" %%A in ('dir /a-d /s "%folder%" ^| find "File(s)"') do (
    set "files=%%A"
)
for /f "tokens=1" %%A in ('dir /ad /s "%folder%" ^| find "Dir(s)"') do (
    set "dirs=%%A"
)

:: 显示结果
echo 统计结果:
echo 文件数量: %files%
echo 子文件夹数量: %dirs%
echo 总大小: !formatted_size!
echo.

:: 列出子文件夹大小
echo 正在分析子文件夹大小，请稍候...
dir /ad /b "%folder%" > "%tempfile%"
echo.
echo 子文件夹大小排行:
echo --------------------------
for /f "delims=" %%D in (%tempfile%) do (
    call :GetFolderSize "%folder%\%%D" subsize
    call :FormatSize !subsize! subformatted
    set "subsize[%%D]=!subsize!"
    set "subformatted[%%D]=!subformatted!"
)

:: 排序并显示
set "count=0"
for /f "tokens=2 delims==" %%S in ('set subsize[ ^| sort /+64 /r') do (
    set /a "count+=1"
    for /f "tokens=1,2 delims=[]" %%A in ("%%S") do (
        echo !count!. %%A - !subformatted[%%A]!
    )
    if !count! equ 10 goto :break
)
:break

:: 清理临时文件
if exist "%tempfile%" del "%tempfile%"

echo.
pause
exit /b

:: 计算文件夹大小的函数
:GetFolderSize
set "size=0"
for /f "tokens=3" %%A in ('dir /a-d /s "%~1" 2^>nul ^| find "File(s)"') do (
    set "size=%%A"
)
set "%~2=%size:"=%"
exit /b

:: 格式化文件大小显示
:FormatSize
setlocal
set "size=%~1"
set "unit=B"
set "size=%size:,=%"

if %size% geq 1024 (
    set /a "size/=1024"
    set "unit=KB"
)
if %size% geq 1024 (
    set /a "size/=1024"
    set "unit=MB"
)
if %size% geq 1024 (
    set /a "size/=1024"
    set "unit=GB"
)
if %size% geq 1024 (
    set /a "size/=1024"
    set "unit=TB"
)

endlocal & set "%~2=%size% %unit%"
exit /b

4. 脚本使用技巧与注意事项

4.1 使用方式

1. 将上述代码保存为FolderSize.bat文件
2. 将该文件复制到需要统计的文件夹中
3. 双击运行即可

4.2 常见问题解决

问题1：脚本闪退

• 可能是路径中包含特殊字符，尝试将文件夹路径用引号括起来
• 确保脚本以管理员身份运行（某些系统文件夹需要权限）

问题2：结果显示不全

• 可能是文件夹太多导致缓冲区不够，可以右键标题栏→属性→布局，增加屏幕缓冲区高度

问题3：大小显示为0

• 检查文件夹是否为空
• 确保脚本有权限访问该文件夹

4.3 性能优化

对于包含大量文件的文件夹，脚本可能需要较长时间运行。可以通过以下方式优化：

1. 排除某些子文件夹：

bat复制dir /a-d /s "%folder%" | find /v "\node_modules\" | find "File(s)"

2. 只统计特定类型文件：

bat复制dir /a-d /s "%folder%\*.jpg" | find "File(s)"

3. 增加超时判断：

bat复制set "timeout=60" :: 60秒超时
start "" /b /wait cmd /c "dir /a-d /s "%folder%" > "%tempfile%""
timeout /t %timeout% >nul
taskkill /f /im cmd.exe >nul 2>&1

5. 脚本进阶应用

5.1 输出到日志文件

修改脚本，将结果输出到日志文件：

bat复制:: 在脚本开头添加
set "logfile=FolderSize_%date:~0,4%%date:~5,2%%date:~8,2%.log"
echo 统计时间: %date% %time% > "%logfile%"

:: 在显示结果的地方改为
echo 统计结果: >> "%logfile%"
echo 文件数量: %files% >> "%logfile%"
...

5.2 图形化界面

使用mshta命令可以创建简单的图形界面：

bat复制:: 在脚本开头添加
echo 是否显示图形界面(Y/N)?
set /p "choice="
if /i "%choice%"=="Y" (
    mshta "javascript:alert('文件夹大小统计工具\n\n正在分析...');close()"
)

5.3 集成到右键菜单

将脚本添加到文件夹右键菜单：

1. 保存以下内容为add_context.reg：

reg复制Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\Directory\shell\FolderSize]
@="统计文件夹大小"

[HKEY_CLASSES_ROOT\Directory\shell\FolderSize\command]
@="\"C:\\path\\to\\FolderSize.bat\" \"%1\""

2. 双击导入注册表文件

6. 替代方案比较

除了批处理脚本，还有其他方法可以统计文件夹大小：

对于简单的文件夹大小统计需求，批处理脚本是最轻量级的解决方案。如果需要更强大的功能，可以考虑使用PowerShell脚本：

powershell复制Get-ChildItem -Recurse | Measure-Object -Property Length -Sum | Select-Object Sum

7. 实际应用案例

7.1 案例一：清理临时文件夹

创建一个专门用于清理临时文件夹的脚本：

bat复制@echo off
setlocal

:: 统计临时文件夹大小
set "tempfolder=%USERPROFILE%\AppData\Local\Temp"
call :GetFolderSize "%tempfolder%" tempsize
call :FormatSize %tempsize% tempformatted

echo 临时文件夹当前大小: %tempformatted%
echo.
echo 是否要清理临时文件(Y/N)?
set /p "choice="

if /i "%choice%"=="Y" (
    echo 正在清理...
    del /q /f /s "%tempfolder%\*.*"
    rmdir /q /s "%tempfolder%"
    mkdir "%tempfolder%"
    echo 清理完成!
) else (
    echo 已取消清理
)

pause
exit /b

:: 包含之前定义的GetFolderSize和FormatSize函数
...

7.2 案例二：监控项目文件夹增长

创建一个定期监控项目文件夹大小的脚本：

bat复制@echo off
setlocal

:: 配置
set "projectfolder=C:\Projects\MyProject"
set "logfile=%projectfolder%\size_log.csv"

:: 检查日志文件是否存在
if not exist "%logfile%" (
    echo 日期,时间,大小(B),大小(格式化) > "%logfile%"
)

:: 获取当前大小
call :GetFolderSize "%projectfolder%" projectsize
call :FormatSize %projectsize% projectformatted

:: 记录到日志
echo %date%,%time%,%projectsize%,%projectformatted% >> "%logfile%"

:: 显示结果
echo 项目文件夹: %projectfolder%
echo 当前大小: %projectformatted%
echo 已记录到: %logfile%

:: 计划下次运行
echo.
echo 脚本将在5分钟后再次运行...
timeout /t 300 >nul
start "" "%~f0"

exit /b

:: 包含之前定义的函数
...

这个脚本会每5分钟记录一次项目文件夹的大小，适合监控项目增长情况。