Python使用os.walk函数遍历目录与高效文件查找指南

Elena

发布时间：2026-10-11| 3人浏览过

原创

本文详细演示如何使用Python标准库os.walk遍历目录树并高效查找文件。通过文件名包含、后缀过滤、目录检索及正则模糊搜索等多种策略，结合性能优化技巧，帮助开发者快速定位目标资源，解决批量文件管理与自动化巡检中的实际需求。

基础准备：理解 os.walk 的返回值

Python 的 os 模块提供了丰富的文件系统接口。其中 os.walk() 是最常用的目录遍历工具之一，特别适合需要深度扫描磁盘结构的场景。该函数会不断进入每个子目录获取信息，每次迭代都会返回一个三元组：

dir_path：当前正在访问的目录路径。
listdir：当前目录下的子目录列表。
files：当前目录下的文件列表。

实现文件查找的几种常用策略

第1步：按部分名称匹配目标文件

当只需根据文件名的片段进行搜索时，可以使用简单的字符串包含逻辑。为了避免因传入的文件名不包含扩展名而漏掉实际带格式的文件，推荐直接使用 in 进行包含判断：

# 定义全局变量保存结果
result = []

def file_search_basic():
    for dir_path, _, files in os.walk(target_path):
        for file in files:
            full_info = os.path.join(dir_path, file)
            if target_name in file:
                result.append(full_info)

第2步：精准过滤文件后缀格式

如果已知目标文件的类型（例如所有 MP3 音频或 PDF 文档），可以根据扩展名进行精确筛选。这种方法比单纯的名字包含更准确，能有效排除同名但不同类的干扰项：

def file_search_by_ext():
    for dir_path, _, files in os.walk(target_path):
        for file in files:
            # 使用 endswith 判断文件是否以特定后缀结尾
            if file.endswith(target_ext):
                result.append(os.path.join(dir_path, file))

第3步：检索特定名称的目录

有时我们需要定位的是文件夹而非文件。可以通过 os.path.basename() 截取路径最后一级的名称，再与目标目录名进行比对，这样无需遍历文件列表即可完成定位：

def dir_search():
    for dir_path, _, _ in os.walk(target_path):
        if os.path.basename(dir_path) == target_dir_name:
            result.append(dir_path)

第4步：运用正则表达式进行模糊搜索

面对命名规则复杂或包含特殊字符的文件，基础字符串匹配可能力不从心。引入 re 模块编写正则表达式，可以实现强大的模糊匹配功能。例如匹配同时包含特定关键词和标点组合的配置档案：

import re

def fuzzy_search():
    pattern = re.compile(target_pattern)
    for dir_path, _, files in os.walk(target_path):
        for file in files:
            ret = pattern.match(file)
            if ret:
                result.append(os.path.join(dir_path, file))

正则语法的核心在于灵活表达不确定性。例如 . 代表任意单个字符，* 表示前面的字符出现零次或多次，.* 即任意长度字符串。针对大小写不敏感的情况，可以使用 [Rr] 匹配单个字符的多种变体；同理，[（(] 能同时兼容中英文标点符号的差异。