Python 如何列出目录中的所有文件

在几种文件处理操作中，列出目录中的所有文件的需求是Python中常见的情况，而且非常简单。Python提供了一个实用的模块os，它提供了可与操作系统、目录和文件无缝工作的函数。我们将使用实际的代码示例和详细的解释介绍各种列出目录中所有文件的策略和方法，帮助您理解背后的概念。

使用os.listdir()列出文件

要列出目录中的所有文件，可以使用os.listdir()函数。让我们通过代码示例来了解步骤：

示例

在这个示例中，我们首先导入os模块。list_files_in_directory()函数以directory_path作为参数，您可以在其中指定要列出文件的目录的路径。

使用os.listdir(directory_path)，我们可以得到指定目录中所有文件和目录的列表。然后，我们通过使用os.path.isfile()检查每个元素的存在来过滤出该列表中的文件。

最后，函数返回在目录中找到的文件列表。如果目录不存在，我们会处理FileNotFoundError并打印出错误信息。

通过这段代码，您可以轻松使用Python列出目录中的所有文件，简化文件管理任务，使您的编程体验更加愉快。

import os

def list_files_in_directory(directory_path):
   try:
      # Use os.listdir() to get a list of all files in the directory
      files_list = os.listdir(directory_path)

      # Filter out directories from the list, keeping only files
      files_list = [file for file in files_list if os.path.
isfile(os.path.join(directory_path, file))]

      return files_list

   except FileNotFoundError:
      print(f"Error: The directory '{directory_path}' 
does not exist.")
      return []

# Replace 'directory_path' with the path of the 
directory you want to list files from
directory_path = '/path/to/your/directory'
files_in_directory = list_files_in_directory(directory_path)

if files_in_directory:
   print("Files in the directory:")
   for file_name in files_in_directory:
      print(file_name)
else:
   print("No files found in the directory.")

输出

对于某个目录，以下是输出结果

Files in the directory:
baz.txt
bar.txt

使用os.listdir()列出文件

示例

首先，我们导入提供了若干有用函数和方法的os模块。

list_files_in_directory()函数接受directory_path作为其参数。directory_path表示目标目录的路径。

通过使用os.listdir(directory_path)函数获取目标目录中的所有文件和文件夹的列表。

我们遍历每个项目，并通过部署os.path.isfile()检查它是否为文件；我们只检索文件并将它们加载到files_list中。

如果目录不存在，将捕获FileNotFoundError并显示错误消息。

import os

def list_files_in_directory(directory_path):
   try:
      # Get a list of all files and directories
 in the specified directory
      all_items = os.listdir(directory_path)

      # Filter out only the files from the list
      files_list = [item for item in all_items if 
os.path.isfile(os.path.join(directory_path, item))]

      return files_list

   except FileNotFoundError:
      print(f"Error: The directory '{directory_path}' 
does not exist.")
      return []
# Replace 'directory_path' with the path of the directory you want to list files from
directory_path = '/path/to/your/directory'
files_in_directory = list_files_in_directory(directory_path)

if files_in_directory:
   print("Files in the directory:")
   for file_name in files_in_directory:
      print(file_name)
else:
   print("No files found in the directory.")

输出

对于某个目录，以下是输出结果：

Files in the directory:
baz
bar

使用os.scandir()进行高效的文件列表

示例

在本示例中，os.listdir()被替换为os.scandir()，以实现对目录中文件的更高效列表。

通过使用os.scandir(directory_path)，我们可以高效地遍历目录条目，不需要显式关闭目录。

通过使用entry.is_file()检查entries中的每个条目是否为文件；如果发现条目是文件，我们将其名称添加到files_list中。

如前所述，我们使用相应的错误消息通知FileNotFoundError的发生。

import os

def list_files_in_directory(directory_path):
   try:
      # Use os.scandir() for a more efficient listing
      with os.scandir(directory_path) as entries:
         files_list = [entry.name for entry in 
entries if entry.is_file()]

      return files_list

   except FileNotFoundError:
      print(f"Error: The directory '{directory_path}' 
does not exist.")
      return []

# Replace 'directory_path' with the path of 
the directory you want to list files from
directory_path = '/path/to/your/directory'
files_in_directory = list_files_in_directory(directory_path)

if files_in_directory:
   print("Files in the directory:")
   for file_name in files_in_directory:
      print(file_name)
else:
   print("No files found in the directory.")

输出

对于某个目录，以下是输出内容

Files in the directory:
baz
bar

递归使用os.walk()

示例

在这个例子中，我们利用os.walk()来做一个递归的列出目录下子目录中的文件列表。

os.walk(directory_path)函数的输出是一个生成器，其中包含根目录、子目录和该目录下的文件。

通过遍历每个元组，并对文件列表中的每个文件，使用os.path.join()创建完整文件路径，并将文件添加到files_list中。

这使我们能够获得一个完整的文件列表，包括子目录中的文件。

import os

def list_files_in_directory(directory_path):
   try:
      # Use os.walk() to get a recursive listing of all files
      files_list = []
      for root, dirs, files in os.walk(directory_path):
         for file in files:
            files_list.append(os.path.join(root, file))

      return files_list

   except FileNotFoundError:
      print(f"Error: The directory '{directory_path}' 
does not exist.")
      return []
# Replace 'directory_path' with the path of 
the directory you want to list files from
directory_path = '/path/to/your/directory'
files_in_directory = list_files_in_directory(directory_path)

if files_in_directory:
   print("Files in the directory:")
   for file_name in files_in_directory:
      print(file_name)
else:
   print("No files found in the directory.")

输出

对于某个目录，以下是输出结果

Files in the directory:
/content/foo/baz
/content/foo/bar

使用pathlib.Path()进行现代列表显示

示例

在这个最后的例子中，我们利用pathlib.Path()来加速Python中的文件列表显示。

pathlib.Path(directory_path)帮助创建一个Path对象；这样我们就可以处理目录及其内容。

我们使用path.iterdir()获取所有目录条目的迭代器，即文件和目录。

在使用file.is_file()时，我们确保检查每个条目是否是文件，如果是，就提取其名称并加入到files_list中。

from pathlib import Path

def list_files_in_directory(directory_path):
   try:
      # Use pathlib.Path() for modern file listing
      path = Path(directory_path)
      files_list = [file.name for file in path.iterdir() if file.is_file()]

      return files_list

   except FileNotFoundError:
      print(f"Error: The directory '{directory_path}' does not exist.")
      return []
# Replace 'directory_path' with the path of the directory you want to list files from
directory_path = '/path/to/your/directory'
files_in_directory = list_files_in_directory(directory_path)

if files_in_directory:
   print("Files in the directory:")
   for file_name in files_in_directory:
      print(file_name)
else:

   print("No files found in the directory.")

输出

对于某个目录，以下是输出结果

Files in the directory:
baz
bar

通过这四个代码示例和它们的解释，你现在拥有了一个多功能的工具包，可以使用Python列出目录中的文件。无论你选择传统的os.listdir()方法，更高效的os.scandir()方法，递归搜索的os.walk()方法，还是最新的pathlib.Path()方法，Python都提供了丰富的选项来满足你的特定需求。

总而言之，列出目录中文件的能力和技巧是简化文件管理任务和增强代码组织的有价值的工具。Python的灵活性和多样性工具使我们能够轻松地浏览目录并提取我们所需的信息。在你继续你的Python之旅时，你应该不断提升你的技能，探索这个多功能语言的广阔可能性。