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 が出る原因は、ほぼ以下に絞られます。
- pip自体がインストールされていない
- python と pip が別のPythonを指している
- 仮想環境(venv)に pip が入っていない
- 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 を使う習慣 をつけることで、
同じエラーはほぼ防げます。
コメントを残す