Pythonでディレクトリの中身を一覧表示する方法【os.listdirの使い方】

Pythonでディレクトリ内のファイルやサブディレクトリを一覧表示したい場合、標準ライブラリの os モジュールに含まれる os.listdir() 関数を使うのが最も基本的な方法です。この関数は、指定したパス内にあるすべてのファイルとディレクトリの名前をリスト形式で返します。

os.listdir() の基本例

使い方は非常にシンプルです。引数にディレクトリのパスを渡すだけで、その中身が一覧表示されます。

>>> import os
>>> os.listdir('.')
['DLLs', 'Doc', 'etc', 'include', 'Lib', 'libs', 'LICENSE.txt', 'NEWS.txt', 'python.exe', 'pythonw.exe', 'README.txt', 'Scripts', 'share', 'tcl', 'Tools', 'w9xpopen.exe']

上記の例では、カレントディレクトリ（'.'）を指定しています。戻り値は文字列のリストであり、ファイル名とディレクトリ名が混在して返される点に注意してください。

ファイルだけを抽出する方法

os.listdir() の結果にはディレクトリも含まれます。もし「ファイルのみ」を取得したい場合は、os.path.isfile() を使ってフィルタリングします。リスト内包表記と組み合わせると、簡潔に書くことができます。

>>> import os
>>> file_list = [f for f in os.listdir('.') if os.path.isfile(os.path.join('.', f))]
>>> print(file_list)
['LICENSE.txt', 'NEWS.txt', 'python.exe', 'pythonw.exe', 'README.txt', 'w9xpopen.exe']

ここで os.path.join() を使っているのは、パスとファイル名を正しく連結して絶対的・相対的な完全なパスを生成するためです。これにより、os.path.isfile() が正確に判定できるようになります。

補足：pathlibを使ったモダンな方法

Python 3.4以降では、より直感的な pathlib モジュールを利用することもできます。

>>> from pathlib import Path
>>> [f.name for f in Path('.').iterdir()]          # ファイルとディレクトリ両方
>>> [f.name for f in Path('.').iterdir() if f.is_file()]  # ファイルのみ

pathlib はオブジェクト指向のAPIを提供しており、OSごとのパス表記の違いを意識せずにコードを書けるため、近年のPython開発ではこちらが推奨されることも多くなっています。

まとめ

• ディレクトリ内の一覧取得には os.listdir(パス) を使う
• ファイルだけ欲しい場合は os.path.isfile() でフィルタリングする
• Python 3.4以降なら pathlib.Path.iterdir() も便利な選択肢

用途に応じてこれらの方法を使い分けることで、ファイル操作を効率的に行えます。