如何在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() 递归搜索文件

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

  • pathname − 相对或绝对路径（包括文件名和完整路径）（带有类 Unix shell 通配符）。通过向 glob() 方法提供绝对或相对路径，我们可以进行文件搜索。具有完整目录结构的路径名称为绝对路径。相对路径是一个路径名，它包含目录名以及一个或多个通配符。
  • recursive − 如果设置为 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年8月17日

5K+ 次浏览

启动您的职业生涯

完成课程后获得认证

开始
广告