MacでVS Codeを使ってPython開発をしていると、
- pip install は成功した
- でも import するとエラーが出る
- VS Code上ではライブラリが使えない
といった状況に遭遇することがあります。
この場合、pip install が失敗しているのではなく、VS Codeの実行環境とpipの環境がズレていることがほとんどです。
この記事では、VS Codeで pip install が反映されないときに確認すべきポイントを、初心者向けに順番で解説します。
※ 本記事は Mac + VS Code + python3 を前提に説明します。
この記事でわかること
- pip install が反映されない典型パターン
- VS Codeで最初に確認すべき設定
- 仮想環境・Python選択のチェック方法
- 正しいpip installの考え方
よくある症状
次のような状態は、本記事の対象です。
pip install requests は成功した
でも import requests でエラーが出るエラー例：
ModuleNotFoundError: No module named 'requests'原因① VS Codeで選択されているPythonが違う
最も多い原因は、
VS Codeで実行しているPythonと、pip installしたPythonが違うケースです。
確認方法
VS Code右下（ステータスバー）に表示されている
Pythonバージョンを確認します。
Python 3.x.xこれが、意図したPythonかを確認してください。
対処法
Cmd + Shift + P→
Python: Select Interpreterから、
pip install したPython（またはvenv）を選択します。
原因② 仮想環境（venv）が有効化されていない
仮想環境を使っている場合、
- pip install は venv で実行
- 実行時はグローバルPython
というズレが起きやすくなります。
確認ポイント
ターミナルに (venv) が表示されているか確認します。
(venv)対処法
source venv/bin/activate有効化後に、再度 pip install を実行してください。
原因③ VS Codeのターミナルと別のターミナルでpip installしている
次のようなケースも多くあります。
- macOS標準ターミナルで pip install
- VS Code内ターミナルで実行
ターミナルが違うと、
使われているPython環境が異なる場合があります。
対処法
- pip install は VS Codeのターミナル内で実行
- 実行も同じターミナルで行う
これで環境ズレを防げます。
原因④ pip3 が別のPythonを指している
pip3 コマンド自体が、
別のPythonに紐づいていることもあります。
確認方法
pip3 --version表示されるパスが、
現在使っているPythonと一致しているか確認します。
原因⑤ requirements.txt を使っていない
チーム作業や複数環境では、
- ライブラリを個別に入れている
- どこに入れたか分からなくなる
という問題が起こりがちです。
対処法
pip install -r requirements.txtで、環境をまとめて再構築すると、
反映されない問題が解消することがあります。
やってはいけない対処法
- sudo を付けて pip install
- 権限を無理に変更する
- 何度も環境を切り替えて混乱する
👉 原因は ほぼ環境のズレ です。
それでも反映されない場合のチェックリスト
- VS Codeで選択しているPythonは正しいか
- 仮想環境が有効化されているか
- pip3 がどのPythonを指しているか
- 同じターミナルで install と実行をしているか
まとめ
VS Codeで pip install が反映されない場合、
原因の多くは次のいずれかです。
- Pythonインタープリタの選択ミス
- 仮想環境の有効化漏れ
- ターミナルの使い分けミス
- pip3 の紐づき違い
pip install が成功しているのに使えない場合は、
「環境のズレ」を疑うのが最短ルートです。