使用 Python 列出目錄下所有文件

介紹

在日常的開發過程中，我們會遇到需要遍歷指定目錄下的所有文件的需求。Python 提供了幾種方法來實現這個功能。本文將介紹如何使用 Python 編寫代碼來實現列出目錄下所有文件的功能，希望能夠幫助讀者更好地應對類似的開發需求。

正文

一、使用 os.walk()

Python 的 os 模塊提供了許多操作文件和目錄的方法。os.walk() 方法可以遞歸地遍歷指定目錄下的所有子目錄和文件。下面是使用 os.walk() 實現列出目錄下所有文件的示例代碼：

import os

dir_path = '/path/to/directory'

for root, dirs, files in os.walk(dir_path):
    for file in files:
        file_path = os.path.join(root, file)
        print(file_path)

代碼解釋：

首先，我們使用 os 模塊中的 os.walk() 方法遍歷指定目錄下的所有子目錄和文件。os.walk() 方法返回三個元素的元組：當前目錄的路徑，當前目錄下的子目錄名稱，當前目錄下的文件名稱。然後，我們使用嵌套的 for 循環遍歷目錄中的每一個文件，並使用 os.path.join() 函數生成文件的完整路徑。最後，我們使用 print() 函數將文件路徑輸出到控制台中。

使用 os.walk() 方法可以減少犯錯的機會，同時還能夠處理符號鏈接和目錄循環結構。不過，由於 os.walk() 方法會遍歷指定目錄下的所有子目錄，因此對於大型的目錄結構，遍歷所需的時間可能會比較長。

二、使用 glob 模塊

glob 模塊提供了一個通配符搜索文件的函數，可以幫助我們選擇符合條件的文件。使用 glob.glob() 函數，我們可以列出指定目錄下的所有文件。下面是使用 glob 模塊實現列出目錄下所有文件的示例代碼：

import glob

dir_path = '/path/to/directory/*'

files = glob.glob(dir_path)

for file in files:
    print(file)

代碼解釋：

首先，我們使用 dir_path 變數定義指定目錄的路徑，並且在路徑末尾添加通配符*，以便匹配目錄下的所有文件。然後，我們使用 glob.glob() 函數列出指定目錄下的所有文件，並將文件的路徑存儲在 files 變數中。最後，我們使用 for 循環遍歷所有文件，並使用 print() 函數將文件路徑輸出到控制台中。

使用 glob 模塊可以快速定位到指定目錄下的文件，只需要一行代碼就能實現。但是，與 os.walk() 方法不同，glob 模塊不會遍歷子目錄下的文件，並且不能處理符號鏈接和目錄循環結構。

三、使用 pathlib 模塊

Python 3.4 引入了 pathlib 模塊，用於處理文件系統路徑。路徑對象可以解析操作和字元串方法的組合，可以輕鬆地解析路徑，獲取路徑的各個部分和統一跨平台地處理路徑分隔符。下面是使用 pathlib 模塊實現列出目錄下所有文件的示例代碼：

import pathlib

dir_path = pathlib.Path('/path/to/directory')

for file in dir_path.glob('*'):
    print(file)

代碼解釋：

首先，我們使用 pathlib.Path() 方法創建路徑對象，並將指定目錄的路徑傳遞給它。然後，我們使用 dir_path.glob() 方法找到指定目錄下的所有文件，並將它們存儲在一個生成器對象中。最後，我們使用 for 循環遍歷生成器對象中的所有文件，並使用 print() 函數將文件路徑輸出到控制台中。

使用 pathlib 模塊可以比較容易地解析路徑，並且可以很好地處理跨平台的問題。相比於 os.walk() 方法和 glob 模塊，pathlib 模塊的使用方法更加 Pythonic，同時也提供了一些方便的輔助方法和屬性。

小結

本文介紹了使用 Python 列出目錄下所有文件的三種方法：使用 os.walk() 方法、使用 glob 模塊和使用 pathlib 模塊。每種方法都有不同的優點和用途，可以根據實際情況進行選擇。希望本文對初學 Python 的讀者有所幫助，幫助他們更好地解決類似的開發需求。