できない.dev

pip「command not found」「No module named pip」の原因と直し方

pip の command not found は、python -m pip で呼べば大半は回避できる。
No module named pip なら pip 本体が無いので、ensurepip か OS パッケージで入れる。

公開: 更新:

症状できない · exit 127
pip --version
bash: line 1: pip: command not found
解決後できた · exit 0
apt-get install -y python3-pip

2026-10-09 に debian:bookworm-slim(pip 23.0.1) で実際に打って取った出力。検証環境の詳細

要約

pip: command not found(Windows では 'pip' は、内部コマンド...として認識されていません)は、pip という名前の実行ファイルが PATH 上に無い ことを意味する。
最初に試すべきは python -m pip --version(環境によっては python3 -m pip)で、これで動くなら pip 本体は存在しており、コマンド名や PATH の問題に切り分けられる。
python -m pip でも No module named pip になる場合は、pip 本体がその Python に入っていない。

実行例

python3 だけを入れた debian:bookworm-slim では、pip が command not found(終了コード 127)、python3 -m pip と python3 -m ensurepip がどちらも No module named … で失敗した。
apt-get install -y python3-pip で pip 23.0.1 が入り、pip も python3 -m pip も同じ場所の pip を指すようになった。

$ pip --version
bash: line 1: pip: command not found
$ echo $?
127
$ python3 -m pip --version
/usr/bin/python3: No module named pip
$ echo $?
1
$ python3 -m ensurepip --upgrade
/usr/bin/python3: No module named ensurepip
$ echo $?
1
$ apt-get install -y python3-pip
$ echo $?
0
$ python3 -m pip --version
pip 23.0.1 from /usr/lib/python3/dist-packages/pip (python 3.11)
$ pip --version
pip 23.0.1 from /usr/lib/python3/dist-packages/pip (python 3.11)
$ which pip pip3
/usr/bin/pip
/usr/bin/pip3
$ python3 -c "import sys; print(sys.executable)"
/usr/bin/python3

— 2026-10-09 時点の出力

検証環境pip 23.0.1 / 2026-10-09 検証
検証日
実行環境
debian:bookworm-slim Debian GNU/Linux 12 (bookworm)
バージョン
  • pip 23.0.1

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. python -m pip で呼ぶ

python -m pip --version
# python コマンドが無い環境では
python3 -m pip --version

python -m pip は「いま実行している Python に紐づく pip」を確実に呼び出せるため、PATH やコマンド名の揺れの影響を受けない。
公式も この呼び方を推奨している(新しいタブで開く)。

2. ensurepip で導入する

python -m ensurepip --upgrade

No module named pip と出る場合は pip 本体が無いので、標準ライブラリの ensurepip(新しいタブで開く) でブートストラップする。

3. OS パッケージで導入する

sudo apt install python3-pip

Debian / Ubuntu のシステム Python では ensurepip が無効化されていることがあり、その場合は OS パッケージから導入する。

4. 環境と実体を確認する

which pip pip3        # Windows: where pip
python -c "import sys; print(sys.executable)"

venv を使っているなら activate を忘れていないか確認する。
activate 後は venv 内の pip が PATH の先頭に来るため、名前の問題はそもそも起きにくくなる。

よくある原因

  1. 多くの Linux / macOS では、pip ではなく pip3 だけが用意されている。
  2. PATH が通っていない。
    pip の実体(Windows は Scripts\pip.exe、Unix 系は bin/pip)が PATH に無い。
  3. pip 本体が入っていない。
    Debian / Ubuntu のシステム Python は pip を同梱しないので、python3-pip パッケージを別途入れる必要がある。
  4. 環境を取り違えている。
    venv を activate しておらず、別の Python 環境で探している。