os.walk比手动递归更稳，因其内置处理符号链接循环、权限拒绝、路径编码异常等边界情况，而手动递归遇PermissionError或UnicodeDecodeError易崩溃。
os.walk 为什么比手动递归更稳
os.walk 是 Python 标准库中专为目录遍历设计的生成器，它内部已处理好符号链接循环、权限拒绝、路径编码异常等边界情况。手动用 os.listdir + 递归容易在遇到 PermissionError 或 UnicodeDecodeError 时直接崩溃，而 os.walk 默认跳过无法访问的子目录（除非显式捕获异常并重抛）。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 始终用
try/except包裹os.walk循环体，单独捕获PermissionError并continue，避免中断整个遍历 - 不要修改
dirs列表以外的返回值；若需过滤子目录，就原地修改dirs（比如dirs[:] = [d for d in dirs if d != "node_modules"]） - 路径拼接务必用
os.path.join(root, file)，别用字符串加法——Windows 下反斜杠和正斜杠混用会出错
Path.rglob 怎么避免匹配到 .git 或 __pycache__
Path.rglob 简洁但默认无过滤逻辑，**/*.py 会进入所有子目录，包括 .git、__pycache__、venv。它不提供类似 os.walk 的 dirs 可修改机制，所以得靠路径判断后跳过。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
path.parent.name或path.parts检查上级目录名，例如if ".git" in path.parts: continue - 对大项目慎用
**：它会先展开全部层级再匹配，内存占用高；可改用两层rglob（如先rglob("*.py")再逐个检查父级）或结合is_file()提前过滤 -
rglob返回的是Path对象，不是字符串；需要绝对路径时调用resolve()，但注意这会触发真实路径解析——遇到坏符号链接会抛FileNotFoundError
PermissionError 和 UnicodeDecodeError 的典型表现与应对
常见错误现象：os.walk 报 [Errno 13] Permission denied: '/root/.ssh'；Path.rglob 在遍历时某次 stat() 调用失败导致 StopIteration 中断或静默跳过。
实操建议：
立即学习“Python免费学习笔记（深入）”；
-
os.walk场景下，在循环外层加try/except PermissionError不起作用——异常发生在next()内部；正确做法是在循环体内对每个root做os.listdir级别的试探，或使用topdown=True+onerror参数传入回调函数 -
UnicodeDecodeError多出现在文件系统编码和 Python 默认编码不一致时（如某些 NAS 返回 GBK 路径）；os.walk本身不 decode 路径名，但后续用open()读文件内容时会崩；此时应显式指定encoding="utf-8"或用errors="ignore" - Linux 下挂载的 NTFS 分区可能含非法 UTF-8 字节序列；
pathlib.Path构造时不会报错，但调用name属性会触发解码——要用bytes_path = os.fsencode(path)绕过
性能差异：什么时候该选 rglob，什么时候坚持用 os.walk
单纯比速度：os.walk 在小目录下略快（C 实现，无对象封装开销）；Path.rglob 在需要链式操作（如 .suffix == ".log" and .stat().st_size > 1024）时更易写，但每次调用方法都涉及一次系统调用。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 只统计数量或路径列表？用
os.walk+sum(len(files) for _, _, files in os.walk(...))，比list(Path(...).rglob("*"))内存友好得多 - 要按修改时间排序？
os.walk先收集再sorted(paths, key=os.path.getmtime)更可控；rglob无法预知总量，排序前得全加载进内存 - 跨平台脚本里别依赖
rglob的 glob 语法扩展（如**/src/**/*.py），某些旧版 Python（os.walk 行为稳定
真正麻烦的从来不是选哪个 API，而是没提前想清楚：要不要进隐藏目录、遇错停不停、路径要不要 resolve、结果要不要去重——这些决策点比函数名重要得多。
