os.walk()比手动递归更稳，因其底层用C实现、不触发RecursionError，自动处理路径分隔符，并内置处理符号链接循环、权限拒绝和编码异常；需用os.path.join拼接路径，修改dirs列表可控制遍历。
用 os.walk() 代替手动递归，避免栈溢出和路径拼接错误
直接调用 os.walk() 是最稳妥的选择。它底层用 C 实现，不依赖 Python 递归调用，不会因目录太深触发 RecursionError；同时自动处理路径分隔符（os.sep），不用自己拼 os.path.join(root, file) 或硬写 '/'。
常见错误是误以为 os.walk() 返回的是“所有文件路径列表”，其实它返回三元组 (root, dirs, files)，其中 dirs 是当前层子目录名列表（不含路径），files 是当前层文件名列表。想获取完整路径必须用 os.path.join(root, name)。
- 若需跳过某些目录（如
'.git'或'__pycache__'），修改dirs列表本身（就地删除）：dirs[:] = [d for d in dirs if d not in {'.git', '__pycache__'}] - 若只关心 .py 文件，别在循环里用
str.endswith('.py')，改用pathlib.Path(file).suffix == '.py'更可靠（处理带点的文件名更准） -
topdown=True（默认）适合过滤目录；topdown=False适合清理操作（先处理子目录再删父目录）
遇到中文路径或特殊字符时报 UnicodeDecodeError 怎么办
Windows 上某些旧终端或文件系统元数据可能含无法被默认编码（如 cp1252）解码的字节，os.walk() 会直接抛错。这不是你代码的问题，而是系统层面的编码残留。
临时绕过方法是捕获异常并跳过该路径：
立即学习“Python免费学习笔记（深入）”；
import os
for root, dirs, files in os.walk('some/path'):
try:
# 正常处理
for file in files:
print(os.path.join(root, file))
except UnicodeDecodeError:
continue # 跳过无法解码的目录层级
更彻底的方案是改用 pathlib.Path.rglob()（Python 3.5+），它对路径编码更宽容，且 API 更直观：
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
from pathlib import Path
for p in Path('some/path').rglob('*.py'):
print(p) # p 是 Path 对象，自带 .resolve()、.stem 等方法
-
rglob()不会因编码问题中断整个遍历，但注意它返回的是Path对象，不是字符串 - 如果必须用字符串路径，用
str(p)转换，不要用p.__str__()或p.as_posix()（后者强制用/，可能在 Windows 上引发兼容性问题）
os.walk() 和 pathlib.Path.rglob() 的性能差异在哪
对小项目（os.walk() 平均快 10–15%，因为它是纯 C 实现，而 pathlib 在每层都构造对象、做类型检查。
不过 pathlib 的链式调用（如 .is_file().suffix）写起来更紧凑，可读性高，调试时也更容易单步。
- 需要极致性能且只读取文件名 → 用
os.walk() - 需要频繁判断文件属性（是否可执行、是否符号链接、大小、修改时间）→ 用
pathlib，避免重复调用os.stat() - 脚本要跨平台且路径逻辑复杂（如替换后缀、提取父级模块名）→
pathlib的方法链天然支持，os.path需多行拼接
为什么 os.listdir() + 手动递归容易出错
很多人试图用 os.listdir() 配合 isdir() 自己写递归，结果卡在相对路径、无限循环或权限拒绝上。
典型陷阱：
- 传给
os.listdir()的是相对路径，但递归调用时没转成绝对路径，导致后续os.path.isdir()判断失败 - 没过滤
'.'和'..'，造成无限递归（尤其在符号链接目录中） - 遇到
PermissionError直接崩溃，而os.walk()默认跳过无权访问的目录，并继续遍历其他分支
除非你明确需要控制遍历顺序或做非常规剪枝（比如按文件大小倒序进入子目录），否则没必要手写递归。标准库已经把边界情况处理得很稳了。
真正麻烦的从来不是“怎么遍历”，而是“遍历中怎么安全地读/改/删”——那部分得单独加异常处理和权限校验，不能指望 os.walk() 替你兜底。
