MacでVS Codeを使ってPython開発をしていると、

• venvを作成したのに自動で切り替わらない
• pip install が反映されない
• importエラーが出る

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

その原因の多くは、VS Codeが仮想環境（venv）を正しく認識できていないことです。

この記事では、VS Codeで仮想環境が自動認識されない理由と、その対処法を初心者向けに順番で解説します。

※ 本記事は Mac + VS Code + python3 + venv を前提に説明します。

この記事でわかること

• VS Codeが仮想環境を認識する仕組み
• 自動認識されない主な原因
• 正しいインタープリタの選び方
• 認識されない場合の安全な対処法

VS Codeが仮想環境を自動認識する仕組み

VS Codeは、次のような場所を自動的に探索します。

• ワークスペース直下の venv フォルダ
• .venv フォルダ
• 設定されたPythonパス

この条件に当てはまらない場合、
仮想環境が存在していても自動では切り替わりません。

原因① venvの場所が想定と違う

次のような構成だと、自動認識されないことがあります。

project/
 ├ src/
 └ venv/

VS Codeを src フォルダだけ開いている場合、
venv を見つけられません。

対処法

• プロジェクトのルートフォルダを開く

ファイル → フォルダーを開く

原因② VS CodeでPythonインタープリタを手動で選んでいない

自動認識に頼ると、
グローバルPythonが使われ続けることがあります。

確認方法

VS Code右下（ステータスバー）の表示を確認します。

Python 3.x.x

対処法（最重要）

Cmd + Shift + P

→

Python: Select Interpreter

→
venv/bin/python を選択します。

👉 これが最も確実な解決方法です。

原因③ 仮想環境を作成後にVS Codeを再起動していない

venv作成直後は、
VS Codeがまだ認識していないことがあります。

対処法

• VS Codeを一度終了
• 再起動してからインタープリタを確認

原因④ Python拡張が無効・未インストール

VS Codeが仮想環境を扱うには、
公式Python拡張が必要です。

確認ポイント

• 拡張機能に Python（Microsoft） が入っているか
• 無効化されていないか

原因⑤ 仮想環境が壊れている

まれに、

• 作成途中でエラーが出た
• 中身が不完全

といった理由で、
venv自体が正しく機能していない場合があります。

対処法

• 仮想環境を削除
• 作り直す

rm -rf venv
python3 -m venv venv

やってはいけない対処法

• 自動認識だけに頼り続ける
• sudo を付けて実行する
• 環境が分からないまま pip install を繰り返す

👉 手動でインタープリタを選ぶのが最短ルートです。

それでも認識されない場合のチェックリスト

• プロジェクトのルートを開いているか
• venv/bin/python を選択しているか
• Python拡張が有効か
• VS Codeを再起動したか

まとめ

VS Codeで仮想環境が自動認識されない場合、

• venvの場所
• 開いているフォルダ
• Pythonインタープリタの選択

のいずれかが原因です。

自動に任せず、手動でインタープリタを指定することで、
ほとんどの問題は解決できます。