VS Code で venv を扱う

この記事では VS Code で Python の仮想環境（venv）を扱う方法を解説しています。

※ venv および仮想環境については[こちら](https://qiita.com/bananuts115/items/9301bc619e15d999c926)の記事で解説しています。

VS Code で Python の仮想環境（venv）を扱うには「Python Environments」拡張機能を利用すると便利です。「Python Environments」拡張機能を使えば、仮想環境の作成や管理を簡単に行うことができます。



## Python Environments について
「Python Environments」は Python の仮想環境の作成や管理、パッケージの追加・削除を簡単に行うことができる VS Code の拡張機能です。Microsoft より提供されています。

:::note
「Python Environments」を使用するには、「Python」拡張機能（version 2024.23 以降）のインストールが必要です。
:::

:::note
「Python Environments」はこの記事を作成している2025年4月22日時点でプレビュー版であるため、拡張機能の開発に伴い機能が変更される可能性があります。
:::



## Python Environments のインストール
VS Code のアクティビティバーで拡張機能をクリックし、検索欄に「python env」と入力します。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/2df1e98c-0e4a-42e8-b542-c33afb6dcb7e.png" width=70%>

検索結果に表示されている「Python Environments」をインストールします。

リリースバージョンではないためメッセージが表示されます。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/16616767-032c-4435-9590-de8bbd2d9658.png" width=100%>

「プレリリースのインストール」をクリックしてインストールします。



## 画面の構成
「Python Environments」をインストールすると VS Code のアクティビティバーに Python のアイコンが表示されます。Python のアイコンをクリックするとサイドバーが以下のように表示されます。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/e6d60ea3-3bed-4ec4-b452-247effd07ff7.png" width=70%>

- PYTHON PROJECTS
現在のワークスペースが表示され、ワークスペースで実行する Python のバージョンが表示されます。
- ENVIRONMENT MANAGERS
  - Global
  インストールされている Python のリストが表示されます。
  - venv
  作成済みの仮想環境のリストが表示されます。



## 仮想環境の作成
サイドバーの venv に表示されている「+」をクリックします。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/04dd8694-5a41-4410-8eb9-1485cd889d63.png" width=40%>

画面上部に仮想環境の作成方法が表示されます。作成方法を選択し仮想環境を作成します。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/058aca10-f169-46b1-acb2-368d815d70ba.png" width=100%>

- Quick Create
現在のワークスペースの直下に「.venv」という名前で仮想環境を作成します。 Python のバージョンはデフォルトで使用するものになります。

- Custom
作成する仮想環境の名前と Python のバージョンを変更できます。パッケージのインストールも同時に行うことができます。

作成した仮想環境はサイドバーに表示されます。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/cf02e695-2a24-46e4-9581-51e7efa227b5.png" width=40%>



## 仮想環境の切り替え
ワークスペースで使用する仮想環境を切り替えるには、サイドバーに表示される右端のチェックマークをクリックします。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/bda105f2-2fb4-49d6-899a-c1a8e0e041be.png" width=40%>

ワークスペースで使用する Python が変更され仮想環境に切り替わります。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/fbffa240-5745-4709-adca-1ea71c6ece1e.png" width=40%>

ワークスペースに仮想環境を設定したうえで VS Code より Python を実行すると、あらかじめ設定した仮想環境が自動的に使用されます。



## パッケージのインストール
仮想環境にパッケージをインストールするには、サイドバーに表示される右から２番目のボックスマークをクリックします。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/876aa5ea-3038-4948-9d8e-aa4a3d79d9ef.png" width=40%>

画面上部でパッケージを選択しインストールします。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/de1d56d7-6c96-451b-bc21-ed775433c174.png" width=100%>

インストールしたパッケージはサイドバーに表示されます。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/bf53d9d2-dd2e-4f99-a7b7-89bbc5d75205.png" width=40%>



## コマンド操作
仮想環境をアクティベートしてコマンド操作するには、サイドバーに表示される左から２番目のアイコンをクリックします。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/423ea746-adcc-41bd-b484-702be930f21c.png" width=40%>

画面下部に新しいターミナルが作成され表示されます。

<img src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/4063083/dade6d7f-d129-459c-881a-63e46bc2fafb.png" width=100%>

仮想環境がアクティベートされた状態でコマンド操作を行うことができます。