Python实现指定深度与忽略目录的文件查找方法

小林子

发布时间：2026-10-13| 5人浏览过

原创

本文介绍如何在Python中实现指定递归深度并忽略特定目录的文件查找功能。通过自定义函数，解决默认递归导致的最大深度报错问题，支持灵活设置查找层级和排除目录列表，适用于不同项目结构下的文件定位需求。

背景

当需要在文件夹中搜索特定文件并返回其所在目录时，若直接使用常规的 os.listdir() 方法，可能会因递归层级过深而触发“超过最大深度”的错误。为此，本文对功能进行了扩展，旨在使该函数适应不同项目结构，无论是文件位于第一层还是更深层级，都能准确定位。

函数

功能：在指定文件夹中查找目标文件，若找到则返回 True 及文件所在的目录路径。

参数：filepath，表示要查找的根目录路径。

参数：filename，表示要查找的目标文件名。

扩展1：find_depth，用于指定查找时的递归深度限制。

扩展2：ignore_path，用于指定查找时需忽略的目录列表。

#!/usr/bin/env python
# coding=utf-8
import os
# from fabric.colors import *

def find_file(self, filepath, filename, find_depth=1, ignore_path=['.git', 'node_modules']):
  """查找文件"""
  # print blue("当前查找目录：{}，递归层级：{}".format(filepath, find_depth))
  # 递归深度控制
  find_depth -= 1
  for file_ in os.listdir(filepath):
    # print cyan("file: {}".format(file_))
    if isfile(join(filepath, file_)):
      # print "当前文件：{}".format(file_)
      if file_ == filename:
        return True, filepath
    elif find_depth <= 0: # 递归深度控制, 为0时退出
      # print yellow("超出递归深度，忽略!")
      continue
    elif file_ in ignore_path: # 忽略指定目录
      # print yellow("此目录在忽略列表中，跳过！")
      continue
    else:
      result, abs_path = self.find_file(filepath=join(filepath, file_),
                       filename=filename,
                       find_depth=find_depth)
      if result:
        print green("找到{}文件，所在路径{}".format(filename, abs_path))
        return result, abs_path
  return False, filepath

result, filepath = find_build(filepath="/data/deploy/jenkins/data/jobs/sit-zjims-mobile/workspace/", filename="gulpfile.js", find_depth=3)

以上这篇Python遍历文件夹、指定遍历深度与忽略目录的方法就是小编分享给大家的全部内容了，希望能给大家一个参考，也希望大家多多支持本站。