pip「Could not open requirements file」の原因と直し方
Could not open requirements file は、-r に渡したパスにファイルが無いと出る。
ファイルのあるディレクトリへ移動するか、-r に正しいパスを渡せば直る。
公開: 更新:
pip install -r requirements.txt [notice] A new release of pip is available: 25.0.1 -> 26.2.1 [notice] To update, run: pip install --upgrade pip ERROR: Could not open requirements file: [Errno 2] No such file or directory: 'requirements.txt'
pip install -r ./config/requirements.txt Requirement already satisfied: pip in /usr/local/lib/python3.12/site-packages (from -r ./config/requirements.txt (line 1)) (25.0.1) WARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager, possibly rendering your system unusable. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv. Use the --root-user-action option if you know what you are doing and want to suppress this warning. [notice] A new release of pip is available: 25.0.1 -> 26.2.1 [notice] To update, run: pip install --upgrade pip
2026-08-31 に python:3.12(pip 25.0.1) で実際に打って取った出力。検証環境の詳細
要約
pip install -r requirements.txt で Could not open requirements file: [Errno 2] No such file or directory: 'requirements.txt' が出るのは、-r に渡したパスにファイルが無いからである。
ほとんどは「実行しているディレクトリにファイルが無い」「パスやファイル名が違う」のどちらかである。
エラーに表示されるファイル名('...' の中身)が自分の想定どおりかをまず確認する。
相対パスはカレントディレクトリから解決される。
実行例
ファイルが無いときは Errno 2 とともにパスがそのまま出るので、まず ls で場所を確かめてから相対パスを直せばよい。
-r を付け忘れた場合はメッセージが変わり、pip 自身が「requirements.txt という名前のパッケージを入れようとしている」と指摘して -r を促してくる。
$ pip install -r requirements.txt
[notice] A new release of pip is available: 25.0.1 -> 26.2.1
[notice] To update, run: pip install --upgrade pip
ERROR: Could not open requirements file: [Errno 2] No such file or directory: 'requirements.txt'
$ echo $?
1$ ls -l requirements.txt
ls: cannot access 'requirements.txt': No such file or directory$ ls -l config/requirements.txt
-rw-r--r-- 1 root root 4 Aug 31 01:16 config/requirements.txt$ pip install -r ./config/requirements.txt
Requirement already satisfied: pip in /usr/local/lib/python3.12/site-packages (from -r ./config/requirements.txt (line 1)) (25.0.1)
WARNING: Running pip as the 'root' user can result in broken permissions and conflicting behaviour with the system package manager, possibly rendering your system unusable. It is recommended to use a virtual environment instead: https://pip.pypa.io/warnings/venv. Use the --root-user-action option if you know what you are doing and want to suppress this warning.
[notice] A new release of pip is available: 25.0.1 -> 26.2.1
[notice] To update, run: pip install --upgrade pip
$ echo $?
0$ pip install requirements.txt
ERROR: Could not find a version that satisfies the requirement requirements.txt (from versions: none)
HINT: You are attempting to install a package literally named "requirements.txt" (which cannot exist). Consider using the '-r' flag to install the packages listed in requirements.txt
[notice] A new release of pip is available: 25.0.1 -> 26.2.1
[notice] To update, run: pip install --upgrade pip
ERROR: No matching distribution found for requirements.txt
$ echo $?
1— 2026-08-31 時点の出力
検証環境Python 3.12.14 / Git 2.47.3 / pip 25.0.1 / 2026-08-31 検証
- 検証日
- 実行環境
python:3.12Debian GNU/Linux 13 (trixie)- バージョン
- Python 3.12.14
- Git 2.47.3
- pip 25.0.1
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。
解決策
1. ファイルの場所を確認して実行する
まず実体があるかを確認する。
ls -l requirements.txt # 無ければ別ディレクトリにある
pip install -r requirements.txtサブフォルダにある場合はパスを明示する。
pip install -r ./config/requirements.txt2. CI / Docker では作業ディレクトリを揃える
WORKDIR や working-directory がファイルの場所と一致しているかを確認する。
Dockerfile なら COPY requirements.txt . の後、同じ WORKDIR で pip install -r requirements.txt を実行する。
書式の詳細は公式の Requirements File Format(新しいタブで開く)にまとまっている。
似たエラー: -r を付け忘れた場合
-r を付けずに pip install requirements.txt と打つと、pip はファイルではなく requirements.txt という名前のパッケージを探すので、このエラーにはならない。
代わりに ERROR: Could not find a version that satisfies the requirement requirements.txt と No matching distribution found for requirements.txt で失敗し、その間に HINT: You are attempting to install a package literally named "requirements.txt" (which cannot exist). Consider using the '-r' flag ... という案内が出る(下の実行例の最後のブロック)。
この場合はファイルの場所を直しても効かず、-r を付ければ直る。
# NG: requirements.txt という名前のパッケージを探してしまう
pip install requirements.txt
# OK
pip install -r requirements.txtよくある原因
- 実行場所がずれている。
ファイルはプロジェクト直下にあるのに、別のディレクトリでpip installしている。 - 名前かパスが違う。
requirement.txt(s が無い)などの綴り間違いがあるか、ファイルがサブフォルダにある。 - CI やコンテナで、想定と違う作業ディレクトリで実行されている。