如何在 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:
# 使用 os.listdir() 获取目录中所有文件的列表
files_list = os.listdir(directory_path)
# 从列表中过滤掉目录，只保留文件
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 []
# 将"directory_path"替换为
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:
# 获取所有文件和目录的列表
in the specified directory
all_items = os.listdir(directory_path)
# 仅从列表中过滤文件
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 []
# 将"directory_path"替换为您要列出文件的目录的路径
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.")
输出
For a certain directory, the following was the output
Files in the directory: baz bar
使用 os.scandir() 进行高效列表
示例
在此当前示例中，os.listdir() 被 os.scandir() 替换，以实现目录中更高效的文件列表。
通过使用 os.scandir(directory_path)，我们可以高效地遍历目录条目；之后无需明确关闭目录。
通过使用 entry.is_file() 检查条目中的每个条目是否为文件；如果发现条目是文件，我们将它的名称添加到 files_list。
如前所述，我们通过相应的错误消息通知 FileNotFoundError 的发生。
import os
def list_files_in_directory(directory_path):
try:
# 使用 os.scandir() 获得更高效的列表
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 []
# 将"directory_path"替换为以下路径
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:
# 使用 os.walk() 获取所有文件的递归列表
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 []
# 将"directory_path"替换为以下路径
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:
# 使用 pathlib.Path() 来列出现代文件
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 []
# 将"directory_path"替换为您要列出文件的目录的路径
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 之旅时，你应该不断磨练你的技能并探索这种多功能语言的广阔可能性。
