Pythonでファイルの存在チェックをする方法｜初心者でもすぐできる実用ガイド

Pythonを使えば、ファイルが存在するかどうかを簡単に確認できます。今回は、基本的な方法から応用テクニック、よくあるエラーまでを初心者にも分かりやすく解説します。

なぜファイルの存在チェックが必要なのか？
Pythonでファイル存在チェックをする基本方法
1. os.path.existsを使う方法
2. os.path.isfileとの違い
pathlibを使ったモダンな方法
応用テクニック
1. ファイルがなければ自動で作成する
2. try-exceptでのエラーハンドリング
よくあるエラーと注意点
ファイル存在チェックの実用シーン
Python初心者におすすめのサービス
まとめ
参考リンク

なぜファイルの存在チェックが必要なのか？

プログラムを作るとき、対象のファイルが存在するかどうかを事前に確認するのは重要です。例えば、存在しないファイルを読み込もうとするとエラーになり、処理が途中で止まってしまいます。そこで、ファイルの存在をチェックしてから処理を進めれば、予期せぬエラーを回避できます。また、ログファイルやデータファイルなどを扱う業務システムでは、必ずと言っていいほど必要になる処理です。そのため、最初に覚えておくとプログラムの信頼性が大きく向上します。

Pythonでファイル存在チェックをする基本方法

os.path.existsを使う方法

もっとも基本的な方法は、os.path.existsを使うことです。


import os

file_path = "sample.txt"

if os.path.exists(file_path):
    print("ファイルは存在します")
else:
    print("ファイルは存在しません")

この方法はとてもシンプルで、存在の有無をTrueまたはFalseで返してくれます。初心者が最初に学ぶには最適です。

os.path.isfileとの違い

os.path.existsはファイルやディレクトリの両方を対象にします。一方、os.path.isfileはファイルのみを判定します。


if os.path.isfile(file_path):
    print("これはファイルです")

つまり、特定のファイルだけを対象にする場合はisfileを使うと誤判定を防げます。

pathlibを使ったモダンな方法

Python3.4以降ではpathlibが推奨される傾向にあります。これはオブジェクト指向的な記法で読みやすいのが特徴です。


from pathlib import Path

file_path = Path("sample.txt")

if file_path.exists():
    print("ファイルが存在します")
else:
    print("ファイルは存在しません")

pathlibを使うと、コードが直感的に理解しやすく、複雑なパス操作も簡単に行えるためおすすめです。

応用テクニック

ファイルがなければ自動で作成する

存在チェックをした後、もしファイルがなければ自動で作成することも可能です。


if not file_path.exists():
    with open(file_path, "w") as f:
        f.write("新規作成されました")

このようにすれば、ログファイルや設定ファイルがなかった場合でも安全に処理を進められます。

try-exceptでのエラーハンドリング

ファイル操作では、存在チェックだけでなく例外処理を組み合わせることも重要です。


try:
    with open("sample.txt", "r") as f:
        data = f.read()
except FileNotFoundError:
    print("ファイルが見つかりません")

この方法なら、チェックし忘れてもプログラムが落ちることを防げます。状況に応じてexists()と例外処理を使い分けるのがベストです。

よくあるエラーと注意点

PermissionError：ファイルが存在しても権限がない場合は開けません。実行環境の権限を確認しましょう。
FileNotFoundError：指定したパスが間違っている場合に発生します。相対パスではなく絶対パスを指定すると解決することがあります。
ディレクトリを誤判定：exists()はフォルダも対象にするため、ファイル限定ならisfile()を使いましょう。

ファイル存在チェックの実用シーン

ファイル存在チェックは、日常的なプログラミングで広く利用されます。例えば、バッチ処理で前日の売上データがあるかどうか確認したり、アプリケーションの初回起動時に設定ファイルを作成したりする場面です。また、Webアプリや機械学習のデータ前処理でも、入力ファイルが欠けていないかどうかを確かめる工程で活用されます。小さな工夫ですが、システムの安定性に大きな影響を与える技術といえます。