Python文件系统遍历_oswalk应用解析【教程】

os.walk()返回(root, dirs, files)三元组：root为当前目录路径，dirs为子目录名列表（可修改以控制遍历），files为文件名列表；均不带路径，需os.path.join拼接。

用 os.walk() 遍历目录，核心是理解它返回的三元组结构和遍历顺序——它按深度优先、自顶向下（默认）逐层访问，每次迭代给出当前目录路径、子目录名列表、文件名列表。

os.walk() 返回值到底是什么？

每次循环得到的是一个包含三个元素的元组：(root, dirs, files)：

• root：当前正在访问的目录的绝对或相对路径（字符串）
• dirs：该目录下所有子目录名组成的列表（不带路径，仅文件名），可修改——这是控制遍历范围的关键
• files：该目录下所有普通文件名组成的列表（同样不带路径）

注意：dirs 和 files 都是纯名称列表，不含路径；若需完整路径，需用 os.path.join(root, name) 拼接。

如何跳过某些目录或提前终止遍历？

因为 dirs 列表在每次迭代中可被就地修改，所以能动态控制下一层访问目标：

立即学习“Python免费学习笔记（深入）”；

• 跳过某个子目录：在循环体内执行 dirs.remove("temp") 或 dirs[:] = [d for d in dirs if d != "node_modules"]
• 只遍历指定层级（如仅当前目录+下一层）：可在进入某层前检查 root.count(os.sep)（Windows 用 root.count("\\")），超深则清空 dirs
• 遇到特定目录立即退出：用 break 可终止当前循环，但不会中断整个遍历；真正中止需用异常或标志位

常见实用场景写法示例

不必每次都从头写循环，针对典型需求有简洁模式：

• 查找所有 .py 文件：if file.endswith(".py"): print(os.path.join(root, file))
• 统计各目录下文件数：记录 len(files)，配合 root 输出即可
• 生成目录树结构：根据 root 深度计算缩进，再拼接 dirs + files 名称
• 安全批量重命名：先收集待处理文件全路径，确认无误后再操作，避免边遍历边改名引发错乱

要注意的坑和替代建议

os.walk() 简单直接，但有些边界情况需留意：

• 路径含中文或特殊字符时，确保 Python 运行环境编码支持（通常 UTF-8 没问题）
• 遇到权限错误（如无读取权限的目录）会抛 PermissionError，建议用 try/except 包裹整个循环
• 符号链接默认不跟进（followlinks=False），设为 True 可能导致无限循环，慎用
• Python 3.5+ 推荐用 pathlib.Path.rglob() 替代简单查找（如 list(p.rglob("*.log"))），更函数式、易读；复杂逻辑仍推荐 os.walk()