FileNotFoundError: [Errno 2]の直し方｜Python

FileNotFoundError: [Errno 2] No such file or directory: 'data/users.csv' は、指定したパスにファイルが無いときのエラーです。 ファイルが確かにあるのに出る場合、多くは 「どこから見たパスか（カレントディレクトリ）」がずれています。

確認環境：Python 3.14（Linux）。フォルダの構成とファイルを作って再現しました（確認日 2026年10月11日）。

同じコードが、実行した場所で動いたり止まったりする

次の構成で試しました。

proj/
└── app/
    ├── main.py
    └── data/
        └── users.csv

# app/main.py
import os
print("cwd:", os.getcwd())
with open("data/users.csv", encoding="utf-8") as f:
    print(f.readline().strip())

cwd: /srv/s4/p9/proj
Traceback (most recent call last):
  File "/srv/s4/p9/proj/app/main.py", line 3, in <module>
    with open("data/users.csv", encoding="utf-8") as f:
FileNotFoundError: [Errno 2] No such file or directory: 'data/users.csv'

"data/users.csv" のような相対パスは、main.py の場所ではなく、カレントディレクトリ（os.getcwd() で表示される場所）から探されます。 pathlib の公式ドキュメントでも、相対パスはカレントディレクトリを基準に解釈されると説明されています。

直し方：スクリプトの場所を基準にする

from pathlib import Path

BASE = Path(__file__).resolve().parent          # main.py があるフォルダ
with open(BASE / "data" / "users.csv", encoding="utf-8") as f:
    print(f.readline().strip())

__file__ は、実行しているスクリプトのパスです。 .resolve().parent でそのフォルダの絶対パスになるので、どこから実行しても同じファイルを開けます。プロジェクトの一番上のフォルダを基準にしたいときは、.parent.parent のようにたどります。

どこから実行されているかで、カレントディレクトリが変わる

「VS Code で動いたのに、タスクスケジューラで動かすと止まる」は、この違いが原因のことがあります。 定期実行するスクリプトは、最初から Path(__file__) を基準にしておくと安心です。

ファイル名が少し違う（全角スペース・拡張子・大文字小文字）

data フォルダに 売上　2024.csv（全角スペース）と report.csv.txt を置いて試しました。

Windows のエクスプローラーは、既定で拡張子を表示しない設定のことがあり、report.csv.txt が report.csv に見えます。 フォルダの中身を Python で一覧にすると、本当の名前が分かります。

import os
print(os.listdir("data"))
# ['users.csv', 'report.csv.txt', '売上\u30002024.csv']

print で表示される一覧では、全角スペースが \u3000 と表示されました。 見た目で区別しにくい文字も、ここで分かります。大文字小文字は、Linux では区別されます。Windows と Mac では既定で区別しないことが多いため、手元で動いたのに Linux のサーバーで止まることがあります。

似たエラーとの違い

書き込み（"w"）でも FileNotFoundError になります。 ファイルは自動で作られますが、フォルダは作られないためです。

from pathlib import Path
out = Path("nodir/out.txt")
out.parent.mkdir(parents=True, exist_ok=True)     # フォルダを先に作る
out.write_text("ok", encoding="utf-8")

Windows のパスが壊れているとき

FileNotFoundError: [Errno 2] No such file or directory: 'C:\\data\new\test.csv'

エラー文のパスの中に、\\ でなく1本の \ の \n・\t が見えたら、文字列の中で改行・タブに変わっています。 r"C:\data\new\test.csv" のように、文字列の前に r を付けます。詳しくは関連記事の「unicodeescapeエラーの直し方｜Windowsのパス」で扱っています。

確認の手順（チェックリスト）

2番の resolve() で表示されるパスが、ファイルがあると思っている場所と違えば、カレントディレクトリが原因です。

よくある質問

Q. Java の FileNotFoundException も同じ原因ですか。 A. 相対パスがカレントディレクトリから探される点は同じです。既存の記事「Java FileNotFoundExceptionの原因と対処｜相対パス早見表」で扱っています。

Q. os.chdir() でカレントディレクトリを変えるのはどうですか。 A. 動きますが、プログラム全体のカレントディレクトリが変わり、ほかの相対パスにも影響します。ファイルを開く部分だけ Path(__file__) を基準にするほうが、影響が小さく済みます。

まとめ

• 相対パスは、スクリプトの場所ではなく、カレントディレクトリから探される
• Path(__file__).resolve().parent を基準にすると、どこから実行しても動く
• VS Code・タスクスケジューラ・cron でカレントディレクトリが変わる
• os.listdir() で本当のファイル名を確かめる（拡張子・全角スペース・大文字小文字）
• 書き込みでもフォルダが無いと FileNotFoundError

参考・出典

確認日はいずれも 2026年10月11日です。

• Python ドキュメント「pathlib」：https://docs.python.org/3/library/pathlib.html
• Visual Studio Code「Python settings reference」（python.terminal.executeInFileDir）：https://code.visualstudio.com/docs/python/settings-reference

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。