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

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

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

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

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

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

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

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

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

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

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

Pythonでファイルやフォルダ（ディレクトリ）が実際に存在するかを確認するには、osモジュールに含まれるos.path.exists()関数を使用します。

この関数は、指定したパス（場所）にファイルやフォルダが見つかればTrue（真）、見つからなければFalse（偽）という結果を返してくれます。これを利用して、if文（条件分岐）と組み合わせるのが一般的な使い方です。

まずは、一番シンプルなプログラムの書き方を見てみましょう。プログラミングが初めての方でも、以下のコードをコピーして試してみてください。

import os

# チェックしたいファイル名を指定します
file_name = "sample.txt"

# ファイルが存在するかどうかを判定
if os.path.exists(file_name):
    print(file_name + "が見つかりました！次の処理に進みます。")
else:
    print(file_name + "が見つかりません。ファイル名が正しいか確認してください。")

このサンプルプログラムでは、sample.txtというファイルがプログラムと同じフォルダにあるかどうかを調べています。もしファイルがなくても、エラーでプログラムが止まることはありません。代わりに「見つかりません」というメッセージを表示して、スマートに処理を終了させることができます。

このように、「いきなりファイルを開こうとせず、まずは存在を確認する」というワンステップを入れるだけで、プログラムの信頼性はグッと高まります。

3. 実行結果を確認してみよう：TrueとFalseの正体

3. 実行結果を確認してみよう：TrueとFalseの正体

先ほどのサンプルコードを実際に自分のパソコンで動かしてみると、状況に合わせて2パターンの結果が表示されます。ここでのポイントは、Pythonが裏側で「True（真）」か「False（偽）」という2つの値で判断しているという点です。

sample.txtが見つかりました！次の処理に進みます。

sample.txtが見つかりません。ファイル名が正しいか確認してください。

初心者の方がつまずきやすいのが、「プログラムがファイルをどう見ているか」です。試しに、判定結果そのものを表示させてみると、その仕組みがもっと分かりやすくなりますよ。

import os

# 判定結果そのものを変数に入れて表示してみる
is_file_exist = os.path.exists("sample.txt")

print("判定結果のデータ型：", type(is_file_exist))
print("判定結果の値：", is_file_exist)

このように、os.path.exists()は「本当にある（True）」か「嘘、ないよ（False）」という「bool（ブール）型」と呼ばれるデータを返してくれます。このシンプルな仕組みのおかげで、複雑な条件分岐も迷わず書けるようになるのです。

4. osモジュールって何？PythonでOS操作を自動化する基本ツール

4. osモジュールって何？PythonでOS操作を自動化する基本ツール

osモジュールは、名前の通り「Operating System（オペレーティングシステム：WindowsやMac、Linuxなど）」をプログラムから自由に操作するための「標準ライブラリ（最初から用意されている道具箱）」です。

通常、ファイルのコピーやフォルダの作成はマウスを使って操作しますが、osモジュールを使えば、それらすべてをPythonコードで自動化できます。今回紹介している os.path.exists() も、この道具箱の中にある便利なツールの一つです。

例えば、今の作業場所に「new_folder」という名前のフォルダがあるか確認し、なければ新しく作成するという「自動整理」のような処理も、たった数行で書けてしまいます。

import os

# フォルダの名前を決める
dir_name = "test_folder"

# もしフォルダが存在しなければ、新しく作る
if not os.path.exists(dir_name):
    os.mkdir(dir_name)
    print(dir_name + "を新しく作成しました！")
else:
    print(dir_name + "は既に存在するので、作成をスキップします。")

このように、osモジュールを使いこなせるようになると、大量のファイルを一括でリネームしたり、特定の条件でデータを整理したりと、パソコン作業の効率が劇的にアップします。ファイルの存在確認は、その「自動化」への第一歩なのです。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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におけるファイル操作の基本をしっかり押さえておくことは、今後の学習において必ず役立つ知識となるでしょう。