ITメモベース

Python・開発環境まわりの「つまずきポイント」を整理するITメモ


Pythonで No module named pip が出る原因と対処法(Mac)

,

MacでPythonを使っていると、次のようなエラーに遭遇することがあります。

ModuleNotFoundError: No module named 'pip'

pipはPythonでライブラリを管理するための標準ツールですが、
環境によっては最初から使えない状態 になっていることがあります。

特にMacでは、Pythonの種類や仮想環境の影響でこのエラーが出やすく、
原因が分からず詰まってしまう人も少なくありません。

この記事でわかること

  • No module named pip エラーが出る主な原因
  • Mac特有のPython・pipの関係
  • pipが使えないときの安全な対処手順
  • 今後同じエラーを防ぐためのポイント

結論:原因はほぼこの4つ

先に結論です。
Macで No module named pip が出る原因は、ほぼ以下に絞られます。

  1. pip自体がインストールされていない
  2. python と pip が別のPythonを指している
  3. 仮想環境(venv)に pip が入っていない
  4. system Python と Homebrew Python が混在している

順番に確認していきましょう。

原因① pipがインストールされていない

Pythonは入っていても、pipが入っていないケースがあります。

確認方法

pip --version

または

pip3 --version

同じエラーが出る場合、pipが未インストールの可能性が高いです。

対処法(Mac)

以下のコマンドを実行します。

python3 -m ensurepip --upgrade

実行後、再度確認してください。

pip3 --version

原因② python と pip が別のPythonを指している

Macでは複数のPythonが共存しやすく、
python と pip が 別の環境を参照している ことがあります。

確認方法

which python3
which pip3

表示されるパスが大きく異なる場合、
Pythonとpipがズレています。

安全な対処法(推奨)

pipは常に python -m pip 形式で使います。

python3 -m pip install ライブラリ名

これにより、Pythonとpipの不一致を防げます。

原因③ 仮想環境(venv)に pip が入っていない

仮想環境を作成した直後に起きやすい原因です。

確認ポイント

仮想環境を有効化した状態で確認します。

source venv/bin/activate
pip --version

ここでエラーが出る場合、venv内にpipがありません。

対処法

python -m ensurepip --upgrade

改善しない場合は、仮想環境の作り直しも有効です。

python3 -m venv venv

原因④ system Python と Homebrew Python の混在

Macには最初から system Python が入っています。

  • /usr/bin/python3(system Python)
  • /opt/homebrew/bin/python3(Homebrew Python)

system Pythonは、pipの利用が制限されていることがあります。

確認方法

which python3

/usr/bin/python3 が表示される場合は注意が必要です。

対処法(おすすめ)

Homebrew版Pythonを使うようにします。

brew install python

よくあるNG例

  • sudo pip install を使う
  • pip と pip3 を混在して使う
  • system Python に無理やり pip を入れる

これらは環境トラブルの原因になります。

まとめ

Macで No module named pip が出る原因は、

  • pipが入っていない
  • Pythonとpipの参照先が違う
  • 仮想環境にpipがない
  • system Pythonを使っている

のいずれかです。

python -m pip を使う習慣 をつけることで、
同じエラーはほぼ防げます。


コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です

PAGE TOP