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文字ずつ読む:見つからなかった名前は何か。スクリプトか、1行目のプログラムか、引数のファイルか
  2. 今いる場所を確認する:ターミナルなら pwd(Windowsは cd)、Pythonなら print(Path.cwd())
  3. 実物の名前を確認する:ls -l(Windowsは dir)で、大文字・小文字・拡張子・リンクかどうかを見る
  4. 見えない文字を疑う:Pythonなら print(repr(パス))
  5. 絶対パスで試す:絶対パスで開けるなら、相対パスの基準(カレントディレクトリ)の問題です

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つの軸で整理しています。

対面・無料|東京・永田町で毎週土曜日13時

この記事のようなコードを、講師に聞きながら動かしてみる

ゼロからはじめるPython入門講座

8年間・累計600回開催/これまで全国で2万人以上が参加

「やはり対面で聞けるのはとても気づきがあり、価値があると思います」

参加者の声

  • 本当に初心者からの講座です。プログラミングに触ったことがなくて大丈夫です
  • 対面だから、その場で聞けます。つまずいた所を持ち帰らずに解決できます
  • 講座は1時間。そのあとも残って学習を続けられ、講師にも質問できます
  • 独学で挫折した方も。糸口が見つかって、講座のあと会員になる方が多くいます

無料で参加する|開催日程を見る

参加費は無料です