2025.07.19(更新日: 2026.06.13)
Pythonの仮想環境「venv」
目次を見るはじめに
Pythonの仮想環境「venv」を作成→起動→無効化する方法をまとめる。
インタープリターを設定する(どのPythonにコードを読ませるか選択する)方法についても触れる。
作成
仮想環境を作成したいディレクトリで、以下のコマンドを入力する。(最後のvenvは仮想環境のフォルダ名)
python -m venv venv
macで行うと、2系のPythonを使用してしまう。
2系のPythonには標準でvenvモジュールが存在しないためエラーになる。

Mac:eki-api shibatahiroshitaka$ python -m venv .venv
/System/Library/Frameworks/Python.framework/Versions/2.7/Resources/Python.app/Contents/MacOS/Python: No module named venv

そのため、python3と明示的に書いた。
hiroki@shibatahiroshitakanoiMac django_todo % python3 -m venv venv
以下のような仮想環境ディレクトリが作成された。

起動
以下のコマンドで仮想環境を起動した。
source venv/bin/activate
起動後にターミナルのプロンプトに(venv)が表示される。
(venv) hiroki@shibatahiroshitakanoiMac django_todo %
インタープリタを選択
View > コマンドパレットをクリックする。

inter で検索をかけて、インタープリターを選択をクリックする。

作成した仮想環境を選択する。

これにより、仮想環境にインストールしたライブラリをVS Codeが正しく認識できる。
無効化
仮想環境を抜けるには、deactivate を入力する。
最後の一言
DjangoやFastAPIなどのプロジェクトでは、ライブラリの依存関係を分離するために仮想環境の利用が推奨される。
コメントを残す