VS CodeでPythonを書いていて、

• pip installしたのに反映されない
• importできない
• ターミナルでは動くのに、VS Codeではエラーになる

といった経験はありませんか。

この原因として非常に多いのが、
VS Codeで選択されているPythonが、意図したものと違っているケースです。

この記事では、
Mac環境で VS CodeがどのPythonを使っているかの確認方法 と
正しいPythonへの変更方法 を、初心者向けに分かりやすく解説します。

※ 本記事は Mac環境（python3）を前提 に説明します。

この記事でわかること

• VS Codeで使用中のPythonを確認する方法
• Pythonがズレてしまう理由
• 正しいPythonへの変更手順
• 仮想環境（venv）利用時の注意点

なぜPythonの選択がズレるのか

Macでは、次のように
複数のPythonが存在する状態がよくあります。

• macOSに元から入っているPython
• 公式インストーラで入れたPython
• 仮想環境（venv）のPython

VS Codeは、
これらの中から 自動で1つを選択します。

その結果、

• pipで入れたライブラリが見えない
• importエラーが出る

といった問題が起こります。

VS Codeで選択されているPythonの確認方法

まず、
VS CodeがどのPythonを使っているかを確認します。

方法① ステータスバーを確認する

VS Code画面下部（ステータスバー）に、
次のような表示があります。

Python 3.x.x

ここをクリックすると、
使用可能なPythonの一覧が表示されます。

方法② コマンドパレットから確認する

1. VS Codeで
   Command + Shift + P を押す
2. 「Python: Select Interpreter」と入力
3. 一覧から現在選択されているPythonを確認

この方法でも、
使用中のPythonを確認できます。

正しいPythonに変更する方法

Pythonの一覧が表示されたら、
次のポイントを意識して選択します。

• 仮想環境を使っている場合
  → venv/bin/python を選ぶ
• 仮想環境を使っていない場合
  → /usr/bin/python3 や
  /Library/Frameworks/.../python3 など

選択後、
VS Codeが自動的に設定を切り替えます。

変更後に必ず確認すべきこと

Pythonを変更したら、
次の点を確認してください。

• ステータスバーの表示が変わっているか
• VS Code内ターミナルで python3 --version が意図したものになっているか

仮想環境を使っている場合は、
プロンプトに (venv) が表示されているかも確認します。

よくあるミスと注意点

Python選択で、
次のようなミスがよくあります。

• Pythonを切り替えたのに、再実行していない
• VS Codeを再起動していない
• ターミナルを開き直していない
• グローバルPythonと仮想環境Pythonを混同している

変更後は、
一度ターミナルを開き直すと安全です。

pipやimportがうまくいかない場合

pip install が反映されない場合は、

• 選択中のPython
• pip3 が指しているPython

が一致していない可能性があります。

この場合は、

• pip3 –version
• which python3

などで、
どのPythonを使っているかを確認する必要があります。

まとめ

VS CodeでPythonの挙動がおかしいときは、
次を必ず確認してください。

• VS Codeで選択されているPython
• 仮想環境が正しく選ばれているか
• ターミナルとエディタの環境が一致しているか

Pythonの選択を正しく行うことで、
多くのエラーは一気に解決します。