No such file or directoryの意味と原因|ファイルが「あるのに」出るときの確認手順(Python・Mac・Linux)
「No such file or directory」は「指定された場所に、そのファイルまたはフォルダがない」という意味のエラーです。ファイルが「あるのに」出るときは、探している場所(今いるフォルダ)がずれているか、パスに見えない文字が混ざっているか、エラーが指しているのが別のファイル(実行に使うプログラム本体など)であることがほとんどです。
この記事では、まずエラーメッセージのどこを読めば「何が見つからなかったのか」がわかるかを説明し、そのうえで、ファイルが確かにあるのに出るケースを、Mac(zsh)とPython 3.12で実際に再現して確認した手順で整理します(2026年10月18日実行)。Pythonの FileNotFoundError の基本的な直し方はFileNotFoundErrorとは?Pythonで発生する原因と解決方法にまとめているので、ここではOSやターミナルを含めた全体の切り分けに絞ります。
No such file or directoryの意味
直訳すると「そのようなファイルまたはディレクトリはありません」です。Python、ターミナルのコマンド、シェルスクリプトなど、どこで出ても中身は同じで、OSが返すエラー番号 2(ENOENT)を文章にしたものです。Pythonで確かめると、番号と文章が対応しているのがわかります(Python公式ドキュメント:errno)。
import errno, os
print(errno.ENOENT, os.strerror(errno.ENOENT))
2 No such file or directory
Pythonの FileNotFoundError: [Errno 2] の「2」もこの番号です。FileNotFoundError は OSError の一種で、ENOENTのときに送出されると公式ドキュメントに書かれています(Python公式ドキュメント:組み込み例外)。
まずメッセージの「どこ」が見つからないのかを読む
同じ文言でも、出た場所によって「見つからなかったもの」が違います。手元のMacで出したメッセージを並べます。
| 出た場面 | 実際のメッセージ | 見つからなかったもの |
|---|---|---|
| Pythonでファイルを開いた | FileNotFoundError: [Errno 2] No such file or directory: 'sample.txt' |
最後の 'sample.txt' |
zshで cd |
zsh:cd:1: no such file or directory: nodir |
移動先のフォルダ nodir |
cat や ls |
cat: nofile.txt: No such file or directory |
引数に渡したファイル |
| bashでスクリプトを実行 | bash: ./nofile.sh: No such file or directory |
実行しようとしたファイル |
| 実行したスクリプトの1行目(シバン) | bad interpreter: /usr/local/bin/python9: no such file or directory |
スクリプトではなく、1行目に書いたプログラム |
| Windowsで作ったスクリプトをMacで実行 | env: python3\r: No such file or directory |
python3 の後ろに改行コードが付いた名前のプログラム |
大事なのは、コロンの後ろ(またはメッセージ中)に書かれたパスが「OSが探した名前そのもの」だという点です。自分が思っている名前と1文字でも違えば見つかりません。下の2行は、表示上は区別しにくい例です。
FileNotFoundError: [Errno 2] No such file or directory: 'data/sample.txt '
FileNotFoundError: [Errno 2] No such file or directory: '~/memo.txt'
1行目はファイル名の末尾に半角スペースが入っています。2行目は ~(ホームフォルダ)がそのまま文字として渡されています。
ファイルが「あるのに」出る7つの原因
1. 今いるフォルダ(カレントディレクトリ)が違う
相対パス(data/sample.txt のように / で始まらないパス)は、スクリプトが置いてある場所ではなく、コマンドを実行した場所から探されます。同じスクリプトでも、実行する場所が変わると結果が変わります。
$ python3 sub_run.py # data/ がある場所で実行
ok
$ cd sub && python3 ../sub_run.py # 1つ下のフォルダから実行
FileNotFoundError: [Errno 2] No such file or directory: 'data/sample.txt'
VS Codeの実行ボタンやタスクスケジューラ、cronなどから動かすと、カレントディレクトリが自分の想定と違うことがよくあります。Pythonなら print(Path.cwd()) で今いる場所を確認し、スクリプトの場所を基準にしたいときは Path(__file__).parent / "data" / "sample.txt" のように書きます。__file__ の使い方はPythonの__file__とは?で説明しています。
2. パスに見えない文字が入っている
コピー&ペーストしたファイル名の末尾のスペース、全角スペース、Windowsの改行コード(\r)などは、画面では見えません。Pythonなら print(repr(パス)) で表示すると、余分な文字が見えるようになります。入力値から作ったパスは .strip() で前後の空白を取り除いてから使います。
3. 「~」がPythonでは展開されない
ターミナルでは ~ が自分のホームフォルダに置き換わりますが、これはシェルの機能です。Pythonの open() に "~/x.txt" を渡しても置き換わらず、上の例のようにそのままの名前で探されます。os.path.expanduser("~/x.txt") や Path("~/x.txt").expanduser() で展開してから使います。
import os
print(os.path.expanduser("~/x.txt"))
/Users/user/x.txt
4. 書き込み先のフォルダがない
ファイルを新しく作るとき(open(..., "w"))も、途中のフォルダが存在しないと同じエラーになります。ファイルは作れても、フォルダまでは自動で作られません。
FileNotFoundError: [Errno 2] No such file or directory: 'out/result.txt'
先に Path("out").mkdir(parents=True, exist_ok=True) でフォルダを作ってから書き込みます。
5. スクリプトの1行目のプログラムがない
./script.py のように直接実行すると、OSは1行目の #!(シバン)に書かれたプログラムを起動しようとします。そこに書いたパスにプログラムがなければ、スクリプト自体はあっても「bad interpreter: … no such file or directory」になります。which python3 で実際の場所を調べて1行目を直すか、#!/usr/bin/env python3 と書いてPATHから探させます。
6. Windowsの改行コード(CRLF)で保存されている
Windowsで作ったスクリプトは行末が \r\n になっていることがあり、MacやLinuxで直接実行すると1行目の python3 が python3\r という名前として扱われます。それが「env: python3\r: No such file or directory」の正体です。エディタで改行コードをLF(VS Codeなら右下の「CRLF」をクリックして「LF」)に変えて保存し直します。
7. シンボリックリンクの先が消えている
ls では名前が表示されるのに開けないときは、リンク切れを疑います。ls -l で -> の先を確認します。Pythonの os.path.exists() はリンク先を見るので、リンク切れでは False になります。
$ ls -l link.txt
lrwxr-xr-x (中略) link.txt -> data/missing.txt
$ cat link.txt
cat: link.txt: No such file or directory
import os
print(os.path.exists("link.txt"), os.path.islink("link.txt"))
False True
存在確認の関数の違いはPython os.path.exists()の使い方で比較しています。
OS別:よく見るパターン
Mac:/opt/homebrew/bin/brew: No such file or directory
ターミナルを開くたびにこのメッセージが出る場合、シェルの設定ファイル(~/.zprofile など)に eval "$(/opt/homebrew/bin/brew shellenv)" が書かれているのに、その場所にHomebrewがない状態です。Homebrewの公式ドキュメントでは、インストール先はApple Siliconが /opt/homebrew、Linuxが /home/linuxbrew/.linuxbrew とされています(Homebrew公式:Installation、2026年10月18日確認)。Homebrewを削除した、別の場所に入れた、設定ファイルだけを別のMacからコピーした、といった場合に起きます。ls /opt/homebrew/bin/brew で実在を確認し、なければ該当の行を削除するか、Homebrewを入れ直します。
Mac・Linux:大文字と小文字
Linuxのファイルシステムは通常、大文字と小文字を区別します。Macの標準設定では区別しないため、Macで動いたコード(Data.csv と data.csv の取り違え)がLinuxのサーバーに置くと動かない、ということが起こります。ファイル名は実物どおりに書くのが確実です。
Windows:パスの「\」
Pythonの普通の文字列では \n が改行、\t がタブとして扱われます。"C:\new\test.txt" と書くと、次のように別の文字列になってしまいます。
p = "C:\new\test.txt"
print(len(p))
print(p)
13
C:
ew est.txt
r"C:\new\test.txt" のように raw 文字列にするか、/ で区切るか、pathlib.Path を使います。raw文字列はPythonのraw文字列とは?で説明しています。
原因を絞り込む確認手順
- メッセージのパスを1文字ずつ読む:見つからなかった名前は何か。スクリプトか、1行目のプログラムか、引数のファイルか
- 今いる場所を確認する:ターミナルなら
pwd(Windowsはcd)、Pythonならprint(Path.cwd()) - 実物の名前を確認する:
ls -l(Windowsはdir)で、大文字・小文字・拡張子・リンクかどうかを見る - 見えない文字を疑う:Pythonなら
print(repr(パス)) - 絶対パスで試す:絶対パスで開けるなら、相対パスの基準(カレントディレクトリ)の問題です
Pythonのエラー全般の読み方はPythonエラー一覧にまとめています。
よくある質問
Q. No such file or directoryとはどういう意味ですか?
「指定された場所に、そのファイルまたはフォルダがない」という意味です。OSのエラー番号2(ENOENT)を文章にしたもので、Pythonでは FileNotFoundError: [Errno 2] として表示されます。
Q. ファイルはあるのにNo such file or directoryが出るのはなぜですか?
多いのは、今いるフォルダが想定と違って相対パスがずれている場合、パスに末尾のスペースなど見えない文字が入っている場合、Pythonで ~ を使っている場合です。スクリプトを直接実行したときは、1行目のシバンに書いたプログラムが見つからないことや、改行コードがCRLFになっていることもあります。
Q. env: python3\r: No such file or directoryを直すには?
スクリプトの改行コードがWindows形式(CRLF)になっているのが原因です。エディタで改行コードをLFに変えて保存し直してください。
Q. Macで /opt/homebrew/bin/brew: No such file or directory と出ます
シェルの設定ファイルにHomebrewを読み込む行があるのに、その場所にHomebrewが入っていない状態です。ls /opt/homebrew/bin/brew で確認し、なければ該当の行を消すか、Homebrewを入れ直します。
Q. Pythonでファイルを書き込もうとしても同じエラーになります
書き込み先のフォルダが存在しないときに出ます。open() はフォルダまでは作らないので、先に Path(“フォルダ名”).mkdir(parents=True, exist_ok=True) で作ってから書き込みます。
インフラまわりの全体像はインフラ・ネットワークの基礎で、クラウド・コンテナ・ネットワークを3つの軸で整理しています。








