path.walk 更安全，因其返回的 dirpath 是 path 对象，可直接调用 .resolve() 或 .is_file() 等方法，无需反复构造 path 实例；且默认不跟随符号链接，配合 on_error 可可控处理权限或路径错误。
Python 3.12 的 Path.walk 是 os.walk 的现代替代方案，它返回生成器、支持 top_down 和 on_error，且不依赖字符串路径拼接 —— 但默认行为和参数细节容易踩坑，尤其在处理符号链接或权限错误时。
为什么 Path.walk 比 os.walk 更安全？
核心区别在于返回值类型：它 yield 的是 (dirpath, dirnames, filenames) 元组，其中 dirpath 是 Path 对象（不是字符串），dirnames 和 filenames 是字符串列表 —— 这意味着你能直接用 .resolve() 或 .is_file() 而不必反复调用 Path(dirpath) / name。
-
dirpath是当前遍历目录的Path实例，已自动规范化（如处理..、.） - 修改
dirnames列表可控制是否进入子目录（和os.walk一样），但注意：不能对filenames做原地过滤，否则无效 - 不自动跟随符号链接，除非显式传
follow_symlinks=True（默认False）
on_error 参数怎么用才不静默失败？
默认情况下，遇到权限拒绝（PermissionError）或路径不存在（FileNotFoundError）会直接抛异常中断遍历。想跳过并继续，必须显式传一个回调函数：
调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。
from pathlib import Path
<p>def handle_error(exc):
print(f"跳过: {exc.filename} -> {type(exc).<strong>name</strong>}")</p><p>for dirpath, dirnames, filenames in Path("/etc").walk(on_error=handle_error):
pass
</p>
-
on_error函数接收一个OSError子类实例，其filename属性是出错路径（字符串），filename可能为None（如打开父目录失败） - 函数返回后遍历继续，但不会重试该目录；若想记录但不打印，函数体可以为空
- 不能用
lambda捕获局部变量来“修复”路径，因为错误发生在底层 C 实现中，回调仅用于通知
top_down 设为 False 时要注意什么？
设 top_down=False 表示后序遍历（先子目录，再当前目录），此时 dirnames 和 filenames 仍是字符串列表，但修改它们**不影响已排队的父级遍历** —— 因为子目录早已入队。
- 这个参数只影响遍历顺序，不影响
dirnames的可修改性；你仍可以删掉某些子目录名来避免后续处理，但对已生成的子目录层级无效 - 常见误用：以为设
top_down=False就能“从底向上删空目录”，其实删除操作需额外逻辑，walk本身不执行任何 I/O 修改 - 性能上无显著差异，但内存占用略高（需缓存整个树结构）
真正容易被忽略的是：如果目录中存在损坏的符号链接（dangling symlink），且未设 follow_symlinks=True，它会被当作普通文件出现在 filenames 中；一旦设了 True，又可能触发 FileNotFoundError —— 这个边界行为不会报错提示，得靠 on_error 捕获才能发现。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
