【Python】ファイル存在チェックの実装方法（pathlib、os.path）

Pythonでファイル操作を行う際「python ファイル存在チェック」の実装方法で迷うことはありませんか？pathlibとos.pathのどちらが最適か、フォルダとの判別はどうすべきかなど、疑問は多いはず。本記事では、モダンな手法から従来の方法まで、状況に応じた使い分けを徹底解説します。この記事を読めば、迷わず最適なコードが書けるようになり、エラーに強い堅牢なプログラムを構築できるようになります。

記事のポイント

• モダンな開発では、オブジェクト指向で直感的に記述できるpathlibモジュールを優先して使うケースが増えています。
• 従来のos.pathも利用可能ですが、ファイルかディレクトリかを厳密に判定するにはis_fileやis_dirを使い分けるのが正解です。
• 単純な存在確認だけでなく、ワイルドカード検索やファイル操作時の競合状態（TOCTOU）への対策など実務的な知識が身に付きます。
• 状況に応じた最適な手法を選択することで、バグが少なくメンテナンス性の高いコードが書けるようになります。

Pythonでファイルやディレクトリの存在を確認する実装パターン

Pythonでファイル操作を行う際、対象のファイルやディレクトリが実際に存在するかを確認することは、プログラムの予期せぬ停止（ FileNotFoundError など）を防ぐために非常に重要です。

現在、Pythonには大きく分けて2つの主要な確認方法があります。一つはPython 3.4以降で導入されたモダンな pathlib モジュール、もう一つは古くから利用されている os.path モジュールです。それぞれの特徴と使い方を詳しく見ていきましょう。

推奨されるモダンな書き方！pathlibモジュールのexistsメソッド

現代のPython開発において最も推奨されるのが pathlib モジュールです。パスを単なる文字列ではなく「オブジェクト」として扱うため、直感的で読みやすいコードが書けるというメリットがあります。

1
from pathlib import Path
2

3
p = Path("example.txt")
4

5
if p.exists():
6
    print("ファイルまたはディレクトリが存在します")
7
else:
8
    print("存在しません")

pathlib を使うと、ファイル操作に関する様々な機能をメソッドチェーンで繋いで記述できるため、複雑なパス操作もスッキリとまとまる傾向があります。

従来の標準的な手法！os.path.existsによるシンプルな存在確認

os.path.exists は、長年Pythonで使われてきた伝統的な手法です。パスを文字列として引数に渡すだけのシンプルな構造で、古いバージョンのPythonとの互換性を保つ必要があるプロジェクトや、小規模なスクリプトでよく利用されます。

1
import os
2

3
filepath = "example.txt"
4

5
if os.path.exists(filepath):
6
    print("ファイルまたはディレクトリが存在します")

非常に簡潔ですが、複雑なパスの結合や属性の取得を行う場合は、 pathlib の方がコードの保守性が高まる場合が多いようです。

ファイル・ディレクトリを厳密に区別して判定するis_fileとis_dirの使い方

「存在する」ことだけでなく、「それがファイルなのか、それともフォルダ（ディレクトリ）なのか」を厳密に区別したい場面は多々あります。 exists() メソッドは両方に対して True を返すため、用途に応じて以下のメソッドを使い分けるのが一般的です。

ファイルのみを対象に存在確認を行う方法

指定したパスが「ファイル」である場合のみ処理を続行したいときは、 is_file() を使用します。これにより、同名のディレクトリが存在する場合の誤作動を防ぐことができます。

1
from pathlib import Path
2

3
file_path = Path("data.csv")
4

5
if file_path.is_file():
6
    print("ファイルが存在します")

ディレクトリ（フォルダ）の有無を判定する方法

一方で、ログ保存用フォルダや設定ディレクトリの有無を確認したい場合は、 is_dir() を利用します。

1
from pathlib import Path
2

3
dir_path = Path("config_folder")
4

5
if dir_path.is_dir():
6
    print("ディレクトリが存在します")

各メソッドの判定結果の違いをまとめると、以下のようになります。

このように、目的の対象が何であるかを明確にしてメソッドを選択することで、より堅牢なプログラムの実装が可能になると考えられます。

Pythonのファイル存在チェックに関するよくある質問（FAQ）

Pythonでファイルやディレクトリの存在確認を実装する際、初心者から中級者までが抱きやすい疑問をまとめました。単なる判定手法だけでなく、実務で直面するパフォーマンスや安全性の観点についても解説します。

Q. pathlibとos.pathのどちらを使うのがベストですか？

結論から述べると、Python 3.4以降のモダンな開発環境では、一般に pathlib を使うスタイルが広く支持されています。ただし、os.path が非推奨（deprecated）になったわけではなく、現在も公式にサポートされている標準的な手法です。

pathlib はパスをオブジェクトとして扱うため、パス区切り文字や結合方法といった多くのOS差異を抽象化し、開発者が意識すべき点を減らしてくれます。一方で、古いバージョンのPython（2.x系など）をサポートする必要がある場合や、既存のプロジェクトが os.path で統一されている場合は、無理に移行せず従来の書き方を踏襲することもあります。

以下の表で、それぞれの主な特徴を比較しました。

多くの場合は pathlib を第一候補としつつも、os.path は非推奨ではなく、既存コードの保守やシンプルな処理では現在も十分に有効です。 そのため、どちらか一方が絶対的に正しいというよりも、プロジェクトの背景に応じた選択が重要になります。

Q. 存在チェック後にすぐファイルを開く際の注意点（競合状態）は？

「ファイルが存在することを確認してから open() で開く」という処理は一見正しく思えますが、マルチスレッド環境や他のプログラムが同時に動いている環境では、 競合状態（Race Condition） が発生するリスクがあります。

例えば、 exists() で存在を確認した直後、別のプロセスによってファイルが削除された場合、 open() を実行する瞬間にファイルが見つからずエラーが発生してしまいます。

これを防ぐためには、事前にチェックする（LBYL: Look Before You Leap）のではなく、 「まず実行してみて、エラーが出たら対処する（EAFP: Easier to Ask for Forgiveness than Permission）」 というアプローチが推奨されることが多いです。

1
try:
2
    with open("data.txt", "r", encoding="utf-8") as f:
3
        content = f.read()
4
except FileNotFoundError:
5
    print("ファイルが見つかりませんでした。")

このように try-except 文を利用することで、存在チェックとファイル操作の間に生じる「隙」をなくし、より堅牢なプログラムを記述できる可能性があります。

Q. ワイルドカード（*.txtなど）を使って複数ファイルの存在を確認できますか？

特定の拡張子を持つファイルが一つでも存在するかどうかを確認したい場合は、 pathlib の glob() メソッドや、標準ライブラリの glob モジュールを利用するのが便利です。

例えば、カレントディレクトリ内に .txt ファイルが存在するかを判定する方法は以下の通りです。

1
from pathlib import Path
2

3
files = list(Path(".").glob("*.txt"))
4

5
if files:
6
    print(f"{len(files)}個のテキストファイルが見つかりました。")
7
else:
8
    print("対象のファイルは存在しません。")

glob() は条件に一致するパスを生成するジェネレータを返すため、 list() でリスト化したり、 next() を使って最初の1つだけを取り出したりすることで、柔軟に存在確認が行えます。 複数ファイルの有無を一括でチェックしたい シーンでは、この手法が非常に効率的であると言えるでしょう。

効率的なPython開発のためのファイル存在チェックまとめ

今回のまとめ：振り返りチェックリスト

• モダンな開発なら pathlib を優先する： これからのPython開発では、直感的にパスを操作でき、可読性も高い pathlib を第一選択にするケースが一般的です。
• 「存在」だけでなく「種類」まで確認する： 単なる exists() だけでなく、is_file() や is_dir() を使い分けることで、ファイルとディレクトリの誤認によるバグを未然に防げます。
• 例外処理との組み合わせを意識する： チェックから実行までの僅かな間に状態が変わることもあるため、確実性を求めるなら try...except による例外処理もセットで検討しましょう。
• アドバイス： まずは今日書くコードから、使い慣れた os.path を pathlib に置き換えてみることから始めてみましょう。コードが驚くほどスッキリするはずですよ！

Pythonでファイルやディレクトリの存在を確認する方法は、開発の効率やコードの可読性に直結する重要な要素です。本記事では、モダンな pathlib モジュールと、従来からの標準的な os.path の2つのアプローチを比較・解説してきました。

状況に応じた使い分けのポイント

現代のPython開発では、特別な理由がない限り pathlib を使うことを好む開発者が多く、実務でもそのスタイルが一般的になりつつあります。これは単に新しい手法であるからという理由だけでなく、パスをオブジェクトとして扱うことで、スラッシュ（ / ）演算子を用いた直感的なパス結合や、メソッドチェーンによるスマートな記述が可能になるためです。

一方で、既存の古いコードベースをメンテナンスする場合や、極めてシンプルな1行のチェックで済ませたい場合には、 os.path も依然として利用されています。

以下の表に、それぞれの主な特徴と使い分けの基準をまとめました。

具体的な実装においては、以下のコードのように「単なる存在確認」で終わらせず、「ファイルなのかディレクトリなのか」を明確に区別する習慣をつけることが大切です。

1
from pathlib import Path
2

3
path = Path("example.txt")
4

5
if path.exists():
6
    if path.is_file():
7
        print("ファイルとして存在します。")
8
    elif path.is_dir():
9
        print("ディレクトリとして存在します。")
10
else:
11
    print("指定されたパスは見つかりませんでした。")

ファイル存在チェックは、プログラムの安定性を高めるための第一歩です。 pathlib のような便利な標準ライブラリを使いこなし、状況に応じて適切なメソッドを選択することで、よりメンテナンス性の高い、美しいPythonコードの記述が期待できるでしょう。

公式ドキュメント

• Python公式ドキュメント：pathlib --- オブジェクト指向のファイルシステムパス
• Python公式ドキュメント：os.path --- 共通のパス名操作
• Python公式ドキュメント：glob --- Unix 形式のパス名のパターン展開
• Python公式ドキュメント：ファイルとディレクトリへのアクセス

Pythonユーザにお勧めの本

人気

スッキリわかるPython入門 第2版 スッキリわかるシリーズ

📦 Amazonで見る 🔴 楽天で見る

独習Python

📦 Amazonで見る 🔴 楽天で見る

Python1年生 第2版 体験してわかる！会話でまなべる！プログラミングのしくみ

📦 Amazonで見る 🔴 楽天で見る