Python `os` 模块文件与目录操作详解45

Python 的 `os` 模块提供了丰富的函数，用于与操作系统进行交互，其中最重要的功能之一就是文件和目录的操作。本文将深入探讨 `os` 模块中与列举文件相关的函数，包括其用法、参数详解、以及在不同场景下的应用示例，并与其他相关模块进行比较。

列举文件，即获取指定目录下所有文件和子目录的信息，是许多程序的基本操作。Python 的 `os` 模块提供了多个函数来实现这一功能，选择哪个函数取决于你的具体需求，例如是否需要递归遍历子目录，是否需要获取文件属性等。

`()`：列出目录中的文件和子目录

(path) 函数是最常用的列举文件的方法。它接受一个路径参数 path，并返回一个包含该目录下所有文件和子目录名称的列表。需要注意的是，该函数只返回文件名，不包含路径信息。import os
directory = "/path/to/your/directory" # 替换成你的目录路径
files = (directory)
print(files)

例如，如果 /path/to/your/directory 目录包含文件 ``、`` 和子目录 `subdir`，则输出将类似于：['', '', 'subdir']。

如果指定的路径不存在，将会抛出 `FileNotFoundError` 异常。良好的代码应该包含异常处理：import os
directory = "/path/to/your/directory"
try:
files = (directory)
for file in files:
print(file)
except FileNotFoundError:
print(f"Error: Directory '{directory}' not found.")
except Exception as e:
print(f"An unexpected error occurred: {e}")

`()`：更高效的目录遍历

Python 3.5 引入了 `()` 函数，它比 `()` 更高效，因为它直接返回 `DirEntry` 对象列表，每个对象包含文件名、类型和其他文件属性信息，避免了多次系统调用，从而提高了性能，尤其是在处理大量文件时。import os
directory = "/path/to/your/directory"
with (directory) as entries:
for entry in entries:
print(, entry.is_file(), entry.is_dir())

entry.is_file() 和 entry.is_dir() 可以方便地判断文件类型。

递归遍历目录：`()`

(top, topdown=True, onerror=None, followlinks=False) 函数用于递归遍历目录树。它生成一个三元组序列，每个三元组包含：(dirpath, dirnames, filenames)。
dirpath: 当前遍历目录的路径
dirnames: 当前目录下所有子目录的名称列表
filenames: 当前目录下所有文件的名称列表

import os
for root, dirs, files in ("/path/to/your/directory"):
for filename in files:
print((root, filename))

(root, filename) 函数用于拼接路径，避免了不同操作系统路径分隔符的问题。

topdown 参数控制遍历顺序，默认为 `True` (先遍历父目录，再遍历子目录)；onerror 参数用于指定错误处理函数；followlinks 参数控制是否遍历符号链接。

`glob` 模块：基于模式匹配的文件查找

glob 模块提供了基于模式匹配查找文件的功能，它可以更方便地找到符合特定模式的文件，例如所有以 `.txt` 结尾的文件。import glob
txt_files = ("/path/to/your/directory/*.txt")
print(txt_files)

它使用了 shell 风格的通配符，例如 `*` 代表任意字符序列，`?` 代表单个字符。

`pathlib` 模块：面向对象的路径操作

Python 3.4 引入了 `pathlib` 模块，提供了一种更面向对象的方式来操作文件和目录。它比 `os` 模块更易于使用和阅读。from pathlib import Path
directory = Path("/path/to/your/directory")
for file_path in ("*"): # 遍历所有文件和目录
print(file_path)
for file_path in ("*.txt"): # 遍历所有 .txt 文件
print(file_path)
for file_path in ("*"): # 递归遍历所有文件和目录
print(file_path)

总而言之，Python 提供了多种方法来列举文件，选择哪种方法取决于你的具体需求和偏好。`()` 适合简单的目录列举；`()` 更高效；`()` 用于递归遍历；`glob` 模块用于基于模式匹配的查找；`pathlib` 模块则提供了一种更现代、更易用的方式。

记住始终进行错误处理，以确保代码的健壮性。 选择最适合你项目需求的工具，并编写清晰、可维护的代码。

2025-06-07

---

上一篇：Python接口自动化测试之DDT数据驱动

下一篇：Python 源代码应用：从基础到进阶，实战案例详解