Pythonでファイルの存在チェックをする方法！初心者向けにos.path.exists()の使い方を解説

Pythonでファイルの存在チェックを行う方法（os.path.exists() の使い方）

先生と生徒の会話形式で理解しよう

生徒

「Pythonで、ファイルがあるかどうかを調べるにはどうしたらいいですか？」

先生

「Pythonには、ファイルが存在しているかどうかを確認する便利な方法がありますよ。os.path.exists()という関数を使えば簡単にチェックできます。」

生徒

「それはどうやって使うんですか？エラーにならないか心配で…」

先生

「大丈夫です！初心者でも使いやすいように、やさしく説明していきましょう。」

1. ファイルの存在チェックとは？エラーを防ぐ重要なステップ

Pythonで外部ファイルを読み込んだり、データを書き込んだりする際、最も発生しやすいトラブルの一つが「指定したファイルが見つからない」というエラー（FileNotFoundError）です。もしファイルが存在しない状態でプログラムを動かそうとすると、処理が強制終了してしまいます。

例えば、大事な顧客データや設定ファイルを読み込むプログラムを作ったとしましょう。そのファイルが誤って削除されていたり、名前が少し違っていたりするだけで、プログラムは止まってしまいます。未経験の方にとっては、これだけで「何が悪いのかわからない！」とパニックになりがちですよね。

そこで役立つのが「ファイルの存在チェック」です。処理を開始する前に「もしファイルがあったら実行する、なければ警告を出す」というクッション（条件分岐）を挟むことで、エラーによる停止を防ぎ、安全で親切なプログラムを作成することができます。

未経験者向けのイメージ例：
料理を作る前に「冷蔵庫に卵があるか確認する」のと同じです。卵がないのに目玉焼きを作ろうとしても失敗してしまいますよね？まずは「あるかどうか」を確認することが、プログラミングでも大切なのです。


# 存在チェックをしない場合のイメージ（ファイルがないとエラーで止まる）
# open("dummy.txt")  # ← ここでプログラムが強制終了！

# 存在チェックをする場合のイメージ（エラーを回避できる）
if ファイルがある場合:
    ファイルを読み込む処理をする
else:
    「ファイルが見つかりませんでした」と画面に表示する

このように、あらかじめ確認する工程を入れることで、ユーザーにとっても使いやすい、信頼性の高いプログラムへと仕上がります。

2. os.path.exists()の基本的な使い方

os.path.exists()は、ファイルやフォルダ（ディレクトリ）が存在するかどうかをチェックするための関数です。

使い方はとてもシンプルで、以下のように書きます。


import os

if os.path.exists("sample.txt"):
    print("ファイルが見つかりました！")
else:
    print("ファイルが存在しません。")

このコードでは、「sample.txt」という名前のファイルが同じフォルダにあるかどうかを調べています。

3. 実行結果を確認してみよう

上のコードを実行したときの結果は、ファイルがあるかどうかによって次のようになります。


ファイルが見つかりました！

または


ファイルが存在しません。

このように、os.path.exists()はTrue（本当）かFalse（うそ）の結果を返してくれます。

4. osモジュールって何？

osモジュールは、「Operating System（オペレーティングシステム）」の略で、Pythonからパソコンのファイルやフォルダなどを操作するための道具箱のようなものです。

このモジュールを使うことで、ファイルの存在確認だけでなく、フォルダの作成やファイル名の変更など、いろいろな操作ができます。

5. 絶対パスと相対パスの違いも知っておこう

ファイルを指定するとき、「どこにあるのか」を示すために「パス（Path）」を使います。

相対パス：今のファイルから見た位置（例："sample.txt"）
絶対パス：パソコンのCドライブなどから見た完全な位置（例："C:/Users/UserName/Desktop/sample.txt"）

どちらもos.path.exists()で使うことができます。ただし、Windowsでは\（バックスラッシュ）ではなく、/（スラッシュ）を使うとエラーが少なくて済みます。

6. ファイルだけでなくフォルダの存在も確認できる

os.path.exists()は、ファイルだけでなく、フォルダ（ディレクトリ）の存在もチェックできます。たとえば次のように使います。


if os.path.exists("my_folder"):
    print("フォルダが見つかりました！")

これにより、プログラムを動かす前に必要なフォルダがあるかどうかを確認できます。

7. ファイルとフォルダを分けてチェックしたい場合

ファイルかフォルダかをはっきり分けて確認したい場合は、以下の関数を使うこともできます。

os.path.isfile()：ファイルかどうかを確認
os.path.isdir()：フォルダかどうかを確認

例えば、ファイルだけをチェックしたいなら次のように書けます。


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

このように目的に応じて使い分けることができます。

8. ファイルの存在チェックを応用する例

例えば、ファイルがあるときだけ内容を読み込むようにしたい場合、次のようなコードになります。


if os.path.exists("memo.txt"):
    with open("memo.txt", "r") as f:
        content = f.read()
        print(content)
else:
    print("ファイルがないので読み込めません。")

このように、存在チェックと組み合わせることで、エラーのない安全なプログラムが書けるようになります。

まとめ

Pythonでファイルの存在を確認するという操作は、実際のプログラム開発においてとても重要な意味を持ちます。特に、外部ファイルを読み込んだり、設定ファイルを利用したり、ログを出力するような処理では、対象となるファイルが本当に存在するかどうかを事前に把握しておくことで、予期せぬエラーを防ぐことができます。この記事では、os.path.exists()を中心に、ファイルとフォルダの存在チェックの方法や、相対パスと絶対パスの違い、さらにファイルの種類を見分けるためのos.path.isfile()やos.path.isdir()の使い分けまで、さまざまな観点から丁寧に理解を深めてきました。実際のコード例を通して、Pythonのファイル操作がどれほど柔軟で使いやすいものなのかが実感できたのではないでしょうか。

ファイルの存在チェックを行う習慣は、プログラムの品質を高めるうえでも欠かせない要素です。特に初心者のうちは、「ファイルがある前提」でコードを書いてしまいがちですが、現実の開発環境では、ファイルが意図せず削除されたり、別の場所に移動されたりすることもあります。そのため、osモジュールを用いた存在確認を適切に利用することは、安全で堅牢なプログラムを作る第一歩といえます。また、フォルダの存在チェックや作成処理と組み合わせることで、自動的に必要な環境を整える仕組みも作れます。用途に応じてパスを切り替えたり、複数の条件を組み合わせたりすることで、柔軟なファイル処理を実現できるようになります。

サンプルプログラムまとめ


import os

# チェックしたいファイル名
target = "note.txt"

# ファイルの存在確認
if os.path.exists(target):
    print("ファイルが存在しています。内容を表示します。")
    with open(target, "r") as f:
        print(f.read())
else:
    print("対象のファイルが見つかりません。新しく作成します。")
    with open(target, "w") as f:
        f.write("はじめてのメモです。")
    print("ファイルを作成しました。")

# フォルダの存在確認
folder = "data_folder"
if not os.path.exists(folder):
    os.mkdir(folder)
    print("フォルダがなかったので作成しました。")
else:
    print("フォルダは既に存在しています。")

# 種類別の確認
path = "sample.txt"
if os.path.isfile(path):
    print("これはファイルです。")
elif os.path.isdir(path):
    print("これはフォルダです。")
else:
    print("指定されたパスは存在しません。")

このように、os.path.exists()を中心としたファイル確認の仕組みを理解することで、プログラムの信頼性は大きく向上します。存在チェックを行うだけでも、エラーの発生を未然に防ぎ、ユーザーにとってわかりやすいメッセージを返すことができるため、使いやすく安全なアプリケーション作りに近づきます。さらに、ファイルとフォルダの違いを正確に把握し、それぞれに適した方法で扱うことで、複雑なファイル操作もスムーズに実装できるようになります。Pythonにおけるファイル操作の基本をしっかり押さえておくことは、今後の学習において必ず役立つ知識となるでしょう。

先生と生徒の振り返り会話

生徒

「os.path.exists()って思ったより簡単に使えるんですね！ファイルがあるかどうか調べるのがこんなに手軽だとは思いませんでした。」

先生

「そうでしょう？ファイルが存在するかどうかを確認しておくだけで、プログラムが途中で止まるのを防げますし、思った以上に便利なんですよ。」

生徒

「フォルダもチェックできるっていうのも驚きました。しかも、必要だったら作ることもできるんですね！」

先生

「その通りです。ファイルとフォルダを両方扱えるので、プログラムを動かすための環境を自動的に整える仕組みも作れますよ。」

生徒

「相対パスと絶対パスの違いもわかりました。これを理解しておかないと、ファイルが見つからない原因になりそうですね…！」

先生

「その通り。パスの理解はとても大切です。習得すれば、より複雑なプロジェクトでも迷わずファイルを扱えるようになりますよ。」

生徒

「今日はすごく理解が深まりました！次はファイルの作成や書き込みももっと練習してみたいです！」

先生

「いいですね。今日学んだ知識をしっかり活かして、さらに実践的なプログラムにも挑戦してみましょう。」

ハローワーク講師による直接指導【Python業務自動化実践セミナー】

職業訓練講師が直接指導！未経験から「Pythonエンジニア」へ、実務の壁を突破する2時間集中。

実務10年PL×職業訓練講師。独学では辿り着けない「商用開発の正解」を2時間で。

「Python × DX推進」の実践。業務自動化とデータ処理をビジネスレベルへ引き上げる2時間。

本講座では、世界的に需要が急増しているPythonの真価を引き出し、単なるプログラミングを超えた「ビジネス課題の解決」に繋げる思考法を学びます。文法習得の先にある、効率的なデータスクレイピングや、AI・機械学習の土台となる高度なデータ前処理技術を120分に凝縮して体験します。