磁盘爆了？一个脚本找出最占空间的文件夹

2026-10-06 · 已实跑验证（递归统计/降序排序/空目录边界全过）

服务器磁盘报警、C 盘飘红，第一件事是搞清楚哪个文件夹吃的空间。Windows 资源管理器要一个个右键看属性，慢；用这个脚本一次扫完，还顺手出一份 CSV 报告。

脚本（dir_size_report.py，纯标准库，无需 pip install）

import argparse, csv, os

def dir_size(path):
    total = 0
    for root, dirs, files in os.walk(path, onerror=lambda e: None):
        for f in files:
            fp = os.path.join(root, f)
            try:
                total += os.path.getsize(fp)
            except OSError:
                pass  # 没权限/文件被删，跳过不中断
    return total

def human(n):
    for u in ("B", "KB", "MB", "GB", "TB"):
        if n < 1024:
            return f"{n:.1f} {u}"
        n /= 1024
    return f"{n:.1f} PB"

ap = argparse.ArgumentParser()
ap.add_argument("target", nargs="?", default=".")
ap.add_argument("--top", type=int, default=20)
ap.add_argument("--out", default="dir_size_report.csv")
args = ap.parse_args()

rows = []
for name in sorted(os.listdir(args.target)):
    p = os.path.join(args.target, name)
    if os.path.isdir(p):
        rows.append((name, dir_size(p)))
rows.sort(key=lambda r: -r[1])

print(f"{'目录':<40} {'大小':>12}")
for name, size in rows[:args.top]:
    print(f"{name:<40} {human(size):>12}")

with open(args.out, "w", newline="", encoding="utf-8-sig") as f:
    w = csv.writer(f)
    w.writerow(["目录", "字节数", "人类可读"])
    w.writerows([(n, s, human(s)) for n, s in rows])

用法

python3 dir_size_report.py /var          # 扫 /var 下各子目录
python3 dir_size_report.py . --top 10 --out 磁盘报告.csv

实测结果

• ✅ 构造「大文件夹」（外层 3MB + 内层 2MB）→ 报告 5.0 MB，递归统计正确
• ✅ 「小文件夹」（1 个 3 字节文件）→ 3.0 B
• ✅ 输出按大小降序：5242880 排在 3 前面
• ✅ 空子目录 → 0.0 B，不报错不中断
• ✅ CSV 用 utf-8-sig 编码，Excel 双击打开中文不乱码

三个实测坑

• 必须 onerror 吞掉 os.walk 的权限错误：扫系统目录（/proc、C:\System Volume Information）时没权限，不处理就直接抛异常整轮报废。
• os.path.getsize 也要 try：扫描过程中文件被删/文件名超长，同样会中断。
• CSV 编码写 utf-8-sig 不是 utf-8：纯 utf-8 的 CSV 在 Windows Excel 里双击打开中文全是乱码，加 BOM 才认。

← 更多免费工具与干货 ｜ 博客目录