エラーの正体と発生メカニズム
Pythonで FileNotFoundError: [Errno 2] No such file or directory: '...' というエラーは、ファイル操作（読み込み・書き込み・削除など）を実行した際、指定されたパスでファイルまたはディレクトリが見つからない場合に発生します。
このエラーの核心は、「Pythonプロセスが実行されている位置」と「ファイルが存在している位置」のズレにあります。多くの初学者は、「エディタのファイルツリーで確認できる場所」が「Pythonの実行時のカレントディレクトリ」と一致すると誤解しやすい点に注意が必要です。
ポイント: エラーメッセージ内のパス表記を確認してください。相対パスで指定している場合、そのパスは「コードファイルの場所」ではなく「コマンドライン実行時のカレントディレクトリ」を基準としています。
エラーの正体と発生メカニズムで迷っていませんか？
実例コードも交えながら、つまずきやすいポイントを順番に整理します。
順番に確認できる形でまとめているので、必要なところからすぐ試せます。
即効性のある解決策
問題を迅速に解決するために、以下の3つの解決策を試してください。複雑な環境構築をせずとも、コードの変更だけで対応可能な方法です。
解決策1 絶対パスでのファイル指定
最も確実な方法は、ファイルの絶対パスを直接指定することです。これにより、カレントディレクトリに関わらず一意の場所を指し示すことができます。
手順:
- ターミナルまたはコマンドプロンプトで、対象ファイルを右クリックし「プロパティ」や「詳細」を表示。
- パスフィールドをコピーします。
- コード内のパス指定部分を
'C:\Users\Name\project\data.csv'のように変更します。
# Windowsの場合（エスケープシーケンスへの注意が必要）
with open('C:\\Users\\YourName\\Documents\\data.txt', 'r') as f:
content = f.read()
# Windowsの場合（raw string推奨）
with open(r'C:\Users\YourName\Documents\data.txt', 'r') as f:
content = f.read()
# macOS/Linuxの場合
with open('/Users/YourName/Documents/data.txt', 'r') as f:
content = f.read()注意: Windowsパスにはバックスラッシュ \ が含まれます。これはエスケープ文字として解釈されやすいため、文字列の先頭に r を付けて raw string として扱うか、バックスラッシュを2重に書くことを推奨します。
解決策2 現在の作業ディレクトリの確認と修正
絶対パスを使いたくない場合、あるいはプロジェクト内での相対パス維持が必要な場合は、現在のカレントディレクトリを確認し、ファイルへの相対パスが正しいか検証します。
多くの開発環境（VS Code, PyCharm, Jupyter Notebook）では、エディタを開いたフォルダとPythonが実行されるフォルダが異なることがあります。
import os
# 現在の作業ディレクトリを表示
print("Current Working Directory:", os.getcwd())
# カレントディレクトリ内のファイル一覧を表示
print("Files in current dir:", os.listdir('.'))判断基準:
os.getcwd()で出力されたパスに、読み込もうとしているファイルが含まれているか確認します。- 含まれていない場合、
os.chdir('ターゲットディレクトリへのパス')で一時的に移動するか、パス指定を見直します。
解決策3 パスの結合で動的にファイルを参照
コードファイルと同じ階層、または特定のサブディレクトリにあるファイルを参照する場合、os.path.join や pathlib を使ってパスを構築するのが安全です。これにより、OSの違いやファイル移動時の保守性を高めます。
import os
# スクリプトが存在するディレクトリを取得
script_dir = os.path.dirname(os.path.abspath(__file__))
# そのディレクトリ内の 'data' フォルダにある 'sample.csv' を参照
target_file = os.path.join(script_dir, 'data', 'sample.csv')
print("Target Path:", target_file)
# 存在確認
if os.path.exists(target_file):
with open(target_file, 'r', encoding='utf-8') as f:
print(f.read())
else:
print(f"File not found: {target_file}")ポイント: __file__ 変数を使うことで、スクリプト自体の物理的な場所を基準にパスを計算できます。これにより、どこからコマンドを実行しても正しいファイルにアクセス可能です。
見落としがちな深掘り原因
パス指定が正しいにもかかわらずエラーが発生する場合、以下の要因が隠れています。
ファイルが存在するのにエラーになるケース
1. ファイル名の大文字小文字問題
macOSやLinuxはファイル名の大文字小文字を区別します。Data.txt を data.txt と指定するとエラーになります。Windowsはデフォルトで大文字小文字を区別しないため、環境依存の不具合として顕在化します。
2. 拡張子の隠蔽
Windowsの設定で「既知のファイルタイプの拡張子を表示しない」になっていると、data.txt という名前のファイルが実際は data.txt.txt である可能性があります。エクスプローラーの設定で拡張子を表示し、実際のファイル名を確認してください。
3. ファイルが開きっぱなし
他のプロセス（Excel, エディタ等）でファイルが開かれている場合、排他ロックがかかっているOSではアクセス拒否されることがあります。ただし、これは通常 PermissionError になるため、FileNotFoundError としては稀ですが、一時的なファイル名の変更やロック解除で解消することもあります。
パワーシェルなどターミナル依存の挙動差
コマンドラインの起動方法によってもカレントディレクトリは変化します。
| 起動方法 | カレントディレクトリの初期値 | 備考 |
|---|---|---|
| エクスプローラーで右クリック→ターミナル | そのフォルダ | 直感的 |
| スタートメニュー検索からターミナル起動 | ユーザーホームディレクトリ | 想定外になりやすい |
| IDE内蔵ターミナル | プロジェクトルート | IDE設定依存 |
注意: IDE上のターミナルと、OS標準のターミナルでは、実行コンテキストが異なることがあります。どのターミナルで python script.py を実行したかを確認してください。
上級者向け：ロバストなファイル処理の設計
エラーを「発生させない」のではなく、「発生してもシステムが停止しない」よう設計することが重要です。
try-exceptブロックの適切な使い分け
ファイル操作は常に例外ハンドリングで包むべきではありません。しかし、ファイルの有無が事前に不明な場合や、一時的なファイルアクセスには有効です。
import logging
try:
with open('config.json', 'r') as f:
config = json.load(f)
except FileNotFoundError:
logging.warning("Config file not found. Using defaults.")
config = {}
except json.JSONDecodeError:
logging.error("Config file is invalid JSON.")
config = {}判断ポイント:
- 必須ファイルなら、エラー時に即座に停止（raise）させるべきです。無視すると後続処理で不可解なバグが発生します。
- オプションファイルなら、デフォルト値へのフォールバックを提供します。
pathlibによるモダンなパス操作
Python 3.4以降は pathlib モジュールの活用を推奨します。文字列操作によるパス結合の誤りを減らし、可読性を高めます。
from pathlib import Path
# パスの定義
project_root = Path(__file__).parent
data_path = project_root / 'data' / 'input.csv'
# 存在確認と読み込み
if data_path.exists():
content = data_path.read_text(encoding='utf-8')
print(content[:100])
else:
print(f"Path does not exist: {data_path}")pathlib はオブジェクト指向なアプローチを提供し、is_file(), is_dir(), glob() などのメソッドでファイル属性を直感的に操作できます。
再現性のあるデバッグ手順
FileNotFoundError に遭遇した際は、以下の順序でチェックを行うことで、90%以上のケースで解決します。
- エラーメッセージのパスをコピー: どのパスをPythonが参照しようとしたかを確認します。
- ファイルエクスプローラーでそのパスを開く: ファイルが存在するか、スペルミス（大文字小文字、拡張子）がないかを確認します。
- カレントディレクトリの確認:
os.getcwd()を実行し、想定と一致するかをチェックします。 - 絶対パスまたはスクリプト基準パスへの切り替え: 環境依存を排除するために、動的なパス生成または絶対パスを使用します。
ファイルパス問題は、環境設定とコードの乖離が原因であるケースが大半です。
コードを書く前に、ファイルシステム上の実際の構造と、Pythonが認識する構造を可視化することから始めてください。これにより、無駄な推測時間を削減し、確実な解決策へと到達できます。
FAQ
コードファイルと同じフォルダにファイルがあるのにエラーになる
これは、カレントディレクトリがコードファイルのある場所と一致していないためです。VS Codeなどでエディタを開いているフォルダと、ターミナルで python script.py を実行した時のカレントディレクトリが異なることがあります。print(os.getcwd()) で確認し、必要に応じて os.chdir() で移動するか、os.path.dirname(os.path.abspath(__file__)) を基準にしたパス指定に変更してください。
絶対パスを指定しても FileNotFoundError が出る
以下の点をチェックしてください。
- パス文字列内のバックスラッシュがエスケープ文字として解釈されていないか（Windows）。raw string
r'C:\...'を使うか、スラッシュ/で記述するか、バックスラッシュを二重にする。 - ファイル名の大文字小文字が正確か（macOS/Linuxでは区別される）。
- 拡張子が隠れていないか（例:
file.txtが実際はfile.txt.txtである場合）。 - 権限の問題ではないか（エラーが
PermissionErrorではないかを確認）。
Jupyter Notebookで発生する場合
Jupyter Notebookは、ノートブックファイル(.ipynb)が保存されているディレクトリをカレントディレクトリとして扱います。セル内で %pwd マジックコマンドを実行し、現在のディレクトリを確認してください。もしデータファイルが別の場所にある場合、絶対パスを指定するか、%cd コマンドでディレクトリを移動してください。
os.path.exists() は True なのに open() でエラーになる
これは「タイムラグ」や「競合状態」が疑われます。ファイルシステムが更新されるまで少し待つ、または open() 直前に再度存在確認を行うのが確実です。また、シンボリックリンクが破れている場合や、ネットワークドライブの接続不安定さも要因になり得ます。
ここまで読んでいただきありがとうございます！
UdemyのPythonコースにはオンラインで学習ができる動画コンテンツがたくさんあります。
当ブログのような文章メインの説明では足りない箇所を補えると思うので、もっと詳しく勉強したいという方はぜひチェックしてみてください！
コメント