C
Python検証済み

Error running 'pip install': "ImportError: No module named pip" の原因と直し方【Dockerで検証済み】

Error running 'pip install': "ImportError: No module named pip" の原因と解決方法。検証済みの解決コマンド付きで、現象→原因→解決→確認の順に最短で直せます。

発生したエラー

エラー出力
Error running 'pip install': "ImportError: No module named pip"

結論:まずこれで直ります

このエラーは、Python環境に pip モジュール自体が存在しないか、削除・破損している場合に発生します。下の解決コマンドを順に実行すれば直ります。

解決コマンド
curl -sS https://bootstrap.pypa.io/get-pip.py -o /tmp/get-pip.py
python /tmp/get-pip.py

現象どんなエラーか

次の操作を行うと(検証環境: python:3.11)、上記のエラーが発生します。まずは下の再現コマンドで、同じ状況を再現できることを確認してください。

検証環境:python:3.11

再現コマンド
python -m pip --version 2>/dev/null || true
python -c "import sys; sys.path = [p for p in sys.path if 'pip' not in p]"
# pipモジュールを削除して再現
pip_location=$(python -c "import pip; print(pip.__file__)" 2>/dev/null | sed 's|/__init__.py||' | sed 's|/pip$||')
rm -rf "$pip_location/pip"
python -m pip --version

原因なぜ起きるのか

このエラーは、Python環境に pip モジュール自体が存在しないか、削除・破損している場合に発生します。原因としては、(1)OSのパッケージマネージャで python のみをインストールして python-pip を入れ忘れた、(2)手動で pip 関連ファイルを消してしまった、(3)仮想環境の作成時に ensurepip が無効化されているシステム Python を使用した、などが挙げられます。 根本的な修正方法は、Python 公式が提供するブートストラップスクリプト get-pip.py を使って pip を再インストールすることです。`curl https://bootstrap.pypa.io/get-pip.py | python` を実行すると、pip・setuptools・wheel が正しくインストールされます。これにより `python -m pip` が正常に動作するようになります。 Ubuntu/Debian 系 Linux の場合は `apt-get install -y python3-pip` でも解決できますが、get-pip.py を使う方法はディストリビューションに依存しない汎用的なアプローチです。

解決解決手順

修正コマンド
curl -sS https://bootstrap.pypa.io/get-pip.py -o /tmp/get-pip.py
python /tmp/get-pip.py

確認直ったか確認する

確認コマンド
python -m pip --version && echo 'pip is available'

動画で見る

この記事の解決手順は実環境で検証しています

山田 英紀(社内SE 5年以上・13業種以上の業務システムを開発/運用)が、 掲載コマンドを検証環境で実行し、再現〜解決〜確認まで通ることを確認しています。

この手順でも直らない・自社の環境で再現する場合

エラー調査・修正から、業務システムの改善までご相談いただけます。

無料で相談する

関連する記事