说真的，日常开发里经常会碰到「这几个源码到底占了多少磁盘？」、「某个压缩包里到底藏了哪些大文件？」这种尴尬场景。光靠资源管理器点点鼠标根本不够精确，也不利于后续分析。别慌，用几行 Python 代码，你就Neng把这些信息抓出来甚至还Neng一键导出成 CSV 或 Excel，省时又省力。

从需求上来kan，这篇文章要帮你实现以下几个目标：

递归遍历普通目录，收集每个文件的绝对路径和字节大小。

识别并打开常见压缩格式，把内部文件同样列出来。

支持按后缀过滤，或者一次性显示所有文件。

把结果导出为 CSV 或 Excel，让同事也Neng一眼kan懂。

听起来像是「大工程」，但其实核心只有两块：遍历+获取大小 和 结果输出。下面我们一步步拆解。

Windows 的「属性」只Neng给出总容量；Linux 的du -sh *虽然好用，却只Neng算目录层级的总和，想拿到每个子文件的具体路径就得再配合find -ls。而且跨平台脚本往往要写好几套命令，这对团队协作极不友好。Python 天生跨平台，一次写完大家douNeng跑。

import os
import zipfile
import tempfile
import shutil
def is_archive:
    return p.lower.endswith)
def get_size:
    try:
        return os.path.getsize
    except OSError:
        return 0
def walk_dir:
    """遍历普通目录"""
    for dirpath, _, filenames in os.walk:
        for fn in filenames:
            if not show_all and exts and not fn.lower.endswith):
                continue
            full = os.path.join
            yield full, get_size
def walk_zip:
    """读取 zip 包内部结构"""
    with zipfile.ZipFile as z:
        for name in z.namelist:
            if name.endswith:   # 跳过目录条目
                continue
            if not show_all and exts and not name.lower.endswith):
                continue
            info = z.getinfo
            yield f"{zip_path}!{name}", info.file_size
def walk_any:
    """统一入口：普通目录 / 压缩包 / 压缩包内部子路径"""
    if os.path.isdir:
        return walk_dir
    elif os.path.isfile and is_archive:
        return walk_zip
    else:
        raise ValueError

代码亮点：

统一返回的是 的 generator，既Ke以直接迭代，也Neng一次性转成 list。

对压缩包内部的路径我们用了「!」Zuo分隔符，这样在后期导出时一眼就Neng辨认来源。

过滤逻辑只在必要时才执行，保持遍历速度。

for p,s in walk_any('.',
                     exts=,
                     show_all=False):
    print

运行后你会kan到类似：

   1245 bytes   ./utils/helpers.py
   3421 bytes   ./app/main.py
   ...

import csv
from openpyxl import Workbook
def export:
    rows = list
    if out_path.lower.endswith:
        with open as f:
            w = csv.writer
            w.writerow','Path'])
            w.writerows
    else:   # 默认走 xlsx
        wb = Workbook
        ws = wb.active
        ws.append','Path'])
        for r in rows:
            ws.append
        wb.save
# 示例：扫描整个项目并保存为 result.xlsx
export(walk_any('C:/my_project',
                exts=None,
                show_all=True),
       'result.xlsx')

Excel 打开后你会发现第一列是数字、第二列是完整路径，甚至还Neng直接在表格里筛选「*.java」之类的后缀。

for p,s in walk_any('libs/sample.zip',
                     exts=,
                     show_all=False):
    print

输出示例：

   54234 bytes  libs/sample.zip!com/example/App.class
   108921 bytes libs/sample.zip!lib/util.jar
   ...

#1 防止 UnicodeDecodeError： 当你尝试读取非 UTF‑8 编码的压缩包时ZippedFile.namelist 有可Neng抛异常。Zui稳妥的办法是使用 .decode 把乱码字符剔除掉，再Zuo匹配。

#2 大文件溢出： Ru果要统计 TB 级别的数据，请务必把结果写入磁盘而不是一次性放进内存，否则 Python 会直接崩掉。Ke以把 generator 按批写入 CSV，每次只处理几千行。

#3 多层嵌套压缩包： 本脚本默认只展开第一层。Ru果业务上真的需要递归解压，Ke以在 walk_zip 内部调用 walk_any, 再配合临时目录清理即可。但请注意磁盘空间占用和安全风险。

#4 跨平台路径分隔符： 我们在拼接内部路径时用了「!」Zuo分隔符，这样无论 Windows 用反斜杠还是 Linux 用正斜杠，dou不会冲突。Ru果你想在 UI 上展示，可自行替换回系统默认分隔符。

#5 性Neng小窍门： Ru果只关心特定后缀，在遍历前把 名集合转成小写元组 ) Neng让判断快上约30%。再者，把临时解压目录提前创建好（) 并在 finally 块里统一清理，也Neng避免残留垃圾文件。

roots = 
all_rows = 
for r in roots:
    all_rows.extend))
# 然后统一 export