VS Code Python Environments拡張で環境地獄を抜ける設定手順
Pythonの環境管理、正直うんざりしていませんか。venvで作った環境、condaで作った環境、pyenvで切り替えたバージョン……気づけばどの環境がどのプロジェクトに紐づいているのか分からなくなる。VS Codeの右下に表示されるインタプリタが意図したものと違っていて、importエラーで数十分溶かす。これが「環境地獄」の実態です。
2026年2月にリリースされたVS Codeの「Python Environments」拡張は、この混乱を一箇所に集約してくれます。venv、conda、pyenv、poetry、pipenvなど複数のツールで作られた環境を、VS Code内で統一的に扱えるようになります。
どんな人に向いているか
この拡張が特に効くのは、以下のような状況にいる人です。
- 複数プロジェクトを同時に抱えていて、環境の切り替えで混乱している
- 副業案件と本業で別の環境管理ツールを使い分けている
- 「なぜかimportできない」トラブルに何度も遭遇している
逆に、単一プロジェクトしか扱わない人や、すでにconda一本で運用がうまく回っている人には、わざわざ導入するメリットは薄いかもしれません。
有効化の手順
Python Environments拡張はVS Codeに段階的にロールアウトされています。まだ自動で有効化されていない場合は、以下の手順で明示的にオンにできます。
- VS Codeの設定を開く(
Ctrl + ,またはCmd + ,) - 検索欄に
python.useEnvsExtensionと入力 - チェックボックスをオンにする
- VS Codeを再起動
再起動後、サイドバーに「Python Environments」というビューが追加されていれば成功です。
環境の作り方は2種類ある
Quick Create(素早く作る)
環境ビューの「+」ボタンを押すと、現在のプロジェクトに最適な環境を自動で作ってくれます。フォルダ内にrequirements.txtやpyproject.tomlがあれば、それを検出して依存パッケージも一緒にインストールしてくれます。
「とりあえず動く環境がほしい」ときはこれで十分です。
Custom Create(細かく指定する)
Pythonのバージョンや環境マネージャを細かく選びたい場合は、コマンドパレット(Ctrl + Shift + P)から Python: Create Environment を実行します。venvで作るかcondaで作るか、Pythonバージョンはいくつにするか、といった選択肢が表示されます。
案件でPythonバージョンが指定されている場合や、チーム内でconda統一のルールがある場合は、こちらを使うことになります。
インタプリタの選択ルールを知っておく
環境地獄の元凶は「どのインタプリタが使われているか分からない」ことです。Python Environments拡張では、インタプリタの選択に明確な優先順位があります。
- プロジェクト設定(
.vscode/settings.jsonで指定されたもの) - ワークスペース既定
python.defaultInterpreterPathで指定されたもの- 自動検出(
.venvフォルダ → システムPython)
この順番で決まるので、「なぜか違うPythonが動いている」という事態が減ります。
重要なのは、拡張が勝手に設定ファイルを書き換えないという点です。インタプリタを選択したり、環境を作成したりといったユーザーの明示的な操作があったときだけ、settings.jsonが更新されます。
チーム開発でGit管理している設定ファイルが知らないうちに変わっていた、という事故を防げます。副業案件で複数リポジトリを行き来する人にとっては、この仕様はかなり安心材料になるはずです。
パッケージ管理も環境ビューから
環境を選択した状態で、パッケージのインストールや削除も環境ビューから行えます。使われるコマンドは環境の種類によって自動で切り替わります。
- venv環境 → pip
- conda環境 → conda
- uv有効時 → uv pip
社内ルールや案件で「pipは使わないでcondaで入れて」といった指定がある場合は、環境の種類を合わせておく必要があります。
初心者がハマりやすいポイント
ターミナルが使い回される
VS Codeでは、一度開いたPython Terminalは閉じるまで同じものが使い回されます。REPLを起動したあと、そのままファイルを実行すると、REPL内で実行されて混乱することがあります。
REPLから抜けるには exit() と入力するか、新しいターミナルを開いてください。
環境がリストに出てこない
conda環境がインタプリタ選択に出てこない場合があります。その場合は以下を試してください。
- コマンドパレットで
Python: Select Interpreterを実行 - 「Refresh」を選んで再検出させる
- それでも出ない場合は「Enter interpreter path」で手動指定
端末のプロンプトに表示される環境名と、実際に動いているPythonが違うケースもあります。見た目だけで判断せず、which python(Mac/Linux)や where python(Windows)で確認する癖をつけておくと安心です。
正直なところ、まだ発展途上
Python Environments拡張は便利ですが、万能ではありません。GA(正式版)への移行期ということもあり、挙動が変わる可能性があります。また、pyenvやpoetryとの連携は、venvやcondaほどスムーズではないという声もあります。
既存の環境管理で特に困っていないなら、無理に切り替える必要はないでしょう。ただ、複数ツールが混在していて「どうにかしたい」と思っているなら、試してみる価値はあります。最悪、設定をオフにすれば元に戻せます。