应于内层循环for filename in filenames:中用filename.endswith(('.py', '.txt'))判断，统一转小写并用os.path.join(root, filename)拼路径，避免字符串匹配大小写问题及相对路径风险。
os.walk遍历目录时如何过滤特定后缀文件
直接用 os.walk 遍历所有子目录，再对每个 filename 检查后缀即可。关键不是“怎么走”，而是“在哪判断”——必须在内层循环里对 filenames 列表逐个判断，而不是在 root 或 dirs 上操作。
常见错误是把后缀检查写在 for root, dirs, files in os.walk(...) 外层，结果漏掉深层路径；或者误用 str.endswith() 但传入元组却没加括号，导致 TypeError。
- 后缀判断必须放在
for filename in filenames:循环内部 - 支持多个后缀时，
filename.endswith(('.py', '.js'))的括号不能省——endswith要求参数是元组，不是逗号分隔的散列值 - 注意大小写：Windows 下文件名不区分大小写，但
endswith是纯字符串匹配，'README.TXT'不会匹配'.txt'
避免重复遍历或跳过子目录的陷阱
os.walk 允许就地修改 dirs 列表来控制是否进入某个子目录。如果只是查找文件，通常不需要动它；但如果目标目录层级很深、且已知某些路径不可能含目标文件（比如 node_modules、.git），跳过能显著提速。
修改 dirs 必须用切片赋值（dirs[:] = [...] ）或 del，直接 dirs = [...] 无效——因为 os.walk 内部持有的是原列表引用。
- 跳过隐藏目录：
dirs[:] = [d for d in dirs if not d.startswith('.')] - 跳过构建目录：
dirs[:] = [d for d in dirs if d not in ('__pycache__', 'build', 'dist')] - 不要在循环中直接
remove()dirs，会跳过后续项
相对路径 vs 绝对路径：返回结果该用哪个？
默认 os.walk 返回的是相对于起始路径的 root，拼接文件名后仍是相对路径。多数场景下需要绝对路径（比如后续要 open() 或传给其他工具），此时应先用 os.path.abspath(start_path) 归一化起点，再用 os.path.join(root, filename) 拼出完整路径。
容易被忽略的是符号链接处理：os.walk 默认不跟随软链接目录（followlinks=False）。如果目标文件可能在软链接指向的路径里，得显式传 followlinks=True，但要注意循环链接风险。
- 获取绝对路径：先
start_abspath = os.path.abspath(start_dir)，再os.path.join(root, filename) - 需处理软链接时，加参数
followlinks=True，但务必确认路径结构不含递归软链 - 跨平台注意：
os.path.join自动处理斜杠，别手动拼root + '/' + filename
性能敏感时为什么不用 os.walk？
当目标文件极少、但目录树极大时，os.walk 仍会扫描所有子目录和文件名，开销大。Python 3.5+ 推荐改用 pathlib.Path.rglob，底层更高效，语法也更直观。
例如查找所有 .py 文件：list(Path('src').rglob('*.py')) 比等效的 os.walk 快 20–40%，且自动忽略权限错误（除非显式捕获异常）。
- 简单场景优先用
pathlib：[f for f in Path('project').rglob('*') if f.suffix in {'.py', '.md'}] -
os.walk不可替代的场景：需要同时访问root、dirs、files三者做复杂决策（比如按目录深度动态跳过） - 旧项目兼容 Python os.walk
真正难的不是写出能跑的代码，而是想清楚要不要进 node_modules、要不要跟软链、要不要保留原始路径结构——这些决定比函数调用本身影响更大。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
