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業種以上の業務システムを開発/運用)が、 掲載コマンドを検証環境で実行し、再現〜解決〜確認まで通ることを確認しています。