答案：Python通过os.walk()遍历文件夹，返回目录路径、子目录列表和文件列表的三元组。可结合file.endswith()筛选特定类型文件，使用os.path.join()构建完整路径以处理中文文件名并指定编码避免乱码。通过dirs[:]过滤符号链接防止无限循环，用try-except捕获权限错误，提升遍历安全性与效率。
Python遍历文件夹，本质上就是让你能够用程序化的方式，去“走一遍”你电脑里的文件夹，找到所有你需要的文件。这听起来很简单，但实际上用途非常广泛，比如批量处理文件、统计文件数量等等。
解决方案
Python提供了
os
和
os.path
模块来处理文件和目录。最常用的方法是结合
os.walk()
函数。
os.walk(directory)
会返回一个生成器，每次迭代都会返回一个三元组
(root, dirs, files)
：
立即学习“Python免费学习笔记（深入）”；
-
root
: 当前正在访问的目录路径（字符串）。
-
dirs
:
root
下所有子目录的名称列表（字符串列表）。
-
files
:
root
下所有文件的名称列表（字符串列表）。
下面是一个基本的遍历文件夹的例子：
import os def traverse_directory(directory): for root, dirs, files in os.walk(directory): print(f"当前目录: {root}") for file in files: print(f" 文件: {file}") for dir in dirs: print(f" 目录: {dir}") # 使用示例 traverse_directory("/path/to/your/directory") # 替换成你的文件夹路径
这个代码会打印出指定文件夹及其所有子文件夹下的所有文件和目录。
如何根据文件类型筛选文件？
实际应用中，你可能只想处理特定类型的文件，比如只处理
.txt
文件。这时，可以在遍历时加入判断：
import os def traverse_txt_files(directory): for root, dirs, files in os.walk(directory): for file in files: if file.endswith(".txt"): file_path = os.path.join(root, file) # 获取完整的文件路径 print(f"找到TXT文件: {file_path}") # 在这里可以对文件进行处理，比如读取内容 # with open(file_path, 'r', encoding='utf-8') as f: # content = f.read() # print(content) # 使用示例 traverse_txt_files("/path/to/your/directory")
这里，
file.endswith(".txt")
判断文件名是否以
.txt
结尾。
os.path.join(root, file)
用于构建文件的完整路径，这很重要，因为
os.walk
返回的文件名只是文件名本身，不包含路径信息。
如何处理中文文件名？
在处理中文文件名时，需要注意编码问题。通常，确保你的Python脚本使用UTF-8编码，并在打开文件时指定编码方式，可以避免乱码问题。
如何避免遍历符号链接导致的无限循环？
如果你的文件夹中包含符号链接（类似于快捷方式），
os.walk()
可能会陷入无限循环。你可以使用
os.path.islink()
来判断是否为符号链接，并选择跳过它们。
import os def traverse_without_links(directory): for root, dirs, files in os.walk(directory): dirs[:] = [d for d in dirs if not os.path.islink(os.path.join(root, d))] # 修改dirs列表，跳过符号链接 for file in files: print(f"文件: {file}") # 使用示例 traverse_without_links("/path/to/your/directory")
注意
dirs[:] = ...
这种写法。 它直接修改了
dirs
列表本身，而不是创建一个新的列表。 这样
os.walk()
在下次迭代时，就不会进入被排除的目录。
如何提高遍历速度？
如果你的文件夹结构非常复杂，文件数量巨大，遍历速度可能会比较慢。 有一些方法可以提高速度：
- 使用多线程/多进程: 将遍历任务分解成多个子任务，并行执行。
- 使用更高效的库: 某些第三方库（比如
scandir
）可能比
os.walk()
更快。
- 减少不必要的I/O操作: 如果只需要文件名，避免读取文件内容。
如何处理权限错误？
在遍历某些受保护的文件夹时，可能会遇到权限错误。 可以使用
try...except
语句来捕获
PermissionError
异常，并进行处理，比如跳过该文件夹。