如何在 Python 中列出目录的内容?


计算机的文件系统的目录是一种用于存储和查找文件的组织功能。通过分层组织目录来创建目录树。目录中存在父子关系。文件夹也可以用来指代目录。随着时间的推移,Python 积累了许多可以列出目录内容的 API。有用的函数包括 Path.iterdir、os.scandir、os.walk、Path.rglob 和 os.listdir。

在 Python 中,我们可能需要给定目录中的文件或文件夹列表。您可以通过多种方式实现此目的。

OS 模块

Python 的 OS 模块中提供了一个函数,该函数返回目录中文件或文件夹的列表。

使用 Python 操作系统库列出目录中的文件。Python os.listdir() 方法列出目录中的每个文件和文件夹。函数 os.walk() 返回整个文件树中所有文件的列表。

使用 Python OS 库列出目录中的文件有多种方法。

本文将介绍如何使用 os.listdir() 获取目录中的文件和文件夹。

使用 os.listdir() 方法

Python 中的 os.listdir() 方法显示指定目录中所有文件和文件夹的列表。操作系统采用像 "." 和 ".." 这样的特殊条目在不同目录之间遍历,但此方法不会返回这些条目。

此外,os.listdir() 不会返回第一级目录以上的文件和文件夹。换句话说,os.listdir() 不会返回从该方法找到的子文件夹中的任何内容。os.listdir() 函数只接受一个参数,即要从中检索其文件和文件夹名称的目录的文件路径。

语法

os.listdir(path)

示例

以下是如何使用 os.listdir() 方法列出目录内容的示例 -

# importing the module import os # Providing the path of the directory path = 'D:\Work TP' # Retrieving the list of all the files folders = os.listdir(path) # loop to iterate every item in the list for s in folders: print(s)

输出

以下是上述代码的输出 -

moving files.py
mysql_access.py
stored procedure python-sql.py
trial.py

使用 os.walk() 方法

可以使用 os.walk() 函数获取树中包含的文件列表。该技术遍历树中的每个目录。

然后,os.walk() 返回目录和任何子目录中包含的所有文件和文件夹的名称。

语法

os.walk(topdown)

如果 topdown 设置为 True,则表示应从上到下扫描目录。如果此值为 False(可选),则将从下到上扫描目录。

示例

以下是如何使用 os.walk() 方法列出目录内容的示例

# importing the module import os # Providing the path path = 'D:\Work TP' # loop for retrieving all the files and folders for top-down search for root, directories, contents in os.walk(path, topdown=False): # joining together the root folder where the directory exists of every files along with its name for name in contents: print(os.path.join(root, name)) for name in directories: print(os.path.join(root, name))

输出

以下是上述代码的输出 -

D:\Work TP\SubDirectory\How to copy files from one folder to another using Python.docx
D:\Work TP\SubDirectory\How to create an empty file using Python.docx
D:\Work TP\SubDirectory\Sarika Sample Articles (Python-MySQL Procedures).docx
D:\Work TP\SubDirectory\sql python create table.docx
D:\Work TP\moving files.py
D:\Work TP\mysql_access.py
D:\Work TP\stored procedure python-sql.py
D:\Work TP\trial.py
D:\Work TP\SubDirectory

使用 os.scandir() 方法

Scandir 使用与 listdir 相同的目录迭代系统调用来获取指定路径上文件的名称,但它在两个方面与 listdir 不同。

  • 返回轻量级 DirEntry 对象而不是裸文件名字符串,这些对象包含文件名字符串并提供简单的获取操作系统可能返回的任何其他数据的方法。
  • 与返回整个列表相反,scandir 通过返回生成器而不是列表来充当真正的迭代器。

对于路径中的每个文件和子目录,scandir() 返回一个 DirEntry 对象。

示例

以下是如何使用 os.scandir() 方法列出目录内容的示例 -

# importing the modules import os # getting all the files present inside a specific folder dir_track = r'D:\Work TP' for track in os.scandir(dir_track): if track.is_file(): print(track.name)

输出

以下是上述代码的输出 -

moving files.py
mysql_access.py
stored procedure python-sql.py
trial.py

glob 模块

Python glob 模块允许我们搜索所有路径名,以查找符合给定模式的文件。用于定义提供的文件匹配模式的规则与 Unix shell 中建立的规则相同。

该软件的输出以随机顺序返回遵循这些准则以进行特定模式文件匹配而获得的结果。由于 glob 模块可以遍历我们本地磁盘上的特定点的文件列表,因此在使用文件匹配模式时,我们必须满足某些要求。该模块主要将遍历仅遵循特定模式的文件的磁盘文件列表。

使用 glob() 递归搜索文件

此函数需要两个参数:路径名和递归标志

  • 路径名− 相对或绝对(包括文件名和完整路径)(带有 Unix shell 样式通配符)。通过向 glob() 方法提供绝对或相对路径,我们可以执行文件搜索。具有完整目录结构的路径名称为绝对路径。相对路径是包含目录名称和一个或多个通配符的路径名。
  • 递归− 如果设置为 True,则将执行递归文件搜索。它递归搜索当前目录的子目录中的所有文件。递归标志的默认设置为 False。这意味着它将只查找搜索路径中列出的文件夹。

它递归搜索当前目录的子目录中的所有文件。递归标志的默认设置为 False。这意味着它将只查找搜索路径中列出的文件夹。

语法

glob.glob(pathname, *, recursive=False)

示例

以下是如何使用 glob.glob() 方法使用绝对路径列出目录内容的示例

import glob # relative path for searching all the python files contents = glob.glob("D:\Work TP\*.py",recursive=True) print(contents)

输出

以下是上述代码的输出 -

['D:\Work TP\moving files.py', 'D:\Work TP\mysql_access.py', 'D:\Work TP\stored procedure python-sql.py', 'D:\Work TP\trial.py']

使用 iglob() 循环遍历文件

iglob() 和 glob() 之间的唯一区别在于,前者提供了一个符合模式的文件名迭代器。该方法生成一个迭代器对象,我们可以遍历该对象以获取各个文件的名称。

语法

glob.iglob(pathname,*,recursive=False)

在不实际将所有项目存储在一起的情况下,返回一个生成与 glob() 相同值的迭代器。

当被调用时,iglob() 生成一个可调用对象,该对象将结果加载到内存中。

示例

以下是如何使用 glob.iglob() 方法列出目录内容的示例 -

# importing the module import glob # providing the path glob.iglob('D:\Work TP/*.py') # iterating over the files in that path of directory for items in glob.iglob('D:\Work TP/*.py'): print(items)

输出

以下是上述代码的输出 -

D:\Work TP\moving files.py
D:\Work TP\mysql_access.py
D:\Work TP\stored procedure python-sql.py
D:\Work TP\trial.py

Pathlib 模块

从 Python 3.4 开始,我们可以使用 pathlib 模块,它为大多数 OS 函数提供了包装器。

  • import pathlib− 对于许多操作系统,Pathlib 模块提供类和方法来管理文件系统路径并检索与文件相关的数据。
  • 接下来,使用 pathlib.Path('path') 构造目录的路径。
  • 接下来,使用 iterdir() 遍历目录中的每个条目。
  • 最后,使用 path.isfile() 函数确定当前元素是否为文件。

示例

以下是如何使用 pathlib 模块列出目录内容的示例 -

# importing the module import pathlib # path of the directory dir_path = r'D:\Work TP' # storing the file names res = [] # constructing the path object d = pathlib.Path(dir_path) # iterating the directory for items in d.iterdir(): # checking if it's a file if items.is_file(): res.append(items) print(res)

输出

以下是上述代码的输出 -

[WindowsPath('D:/Work TP/moving files.py'), WindowsPath('D:/Work TP/mysql_access.py'), WindowsPath('D:/Work TP/stored procedure python-sql.py'), WindowsPath('D:/Work TP/trial.py')]

更新于: 2022-08-17

5K+ 阅读量

启动您的 职业生涯

通过完成课程获得认证

开始学习
广告