Pythonのvenv（ブイエンブ）は、プロジェクトごとに独立した環境を構築するための便利なツールです。
本記事では、venvの基本知識から実際の使い方まで、初心者の方にもイメージしやすいように説明していきます。
python venvとは？仮想環境の基礎知識
venvの基本
venvは、仮想環境を作成するためのツールで、Pythonのバージョン3.3以降に標準機能として組み込まれています。
仮想環境とは、特定のプロジェクトに必要なPythonのパッケージやライブラリを独立して管理できる環境のこと。一言で言うと、
「プロジェクトごとに専用の開発環境を作る機能」
です。
これにより、異なるプロジェクト間での依存関係の衝突を避けることができ、開発がスムーズに進むようになります。
venvは、Pythonの標準ライブラリに含まれているため、追加のインストールが不要で、手軽に利用できるのが大きな特徴です。
なぜvenvが必要なの？
venvを使うと、多くのメリットがあります。
Pythonを使う際には、色々な「ライブラリ（便利なプログラムの部品）」をインストールしますよね。
全てのプロジェクトで同一バージョンのライブラリを使用できれば問題ありません。しかし、ライブラリ間の干渉などにより、ライブラリの動作バージョンがプロジェクト毎に異なる場合も出てきます。
- プロジェクトA → 「ライブラリXの バージョン1」を使用
- プロジェクトB → 「ライブラリXの バージョン2」を使用
通常のPython環境は、全てのプロジェクトが同じ環境で動作します。このような問題が発生すると、「同じライブラリの違うバージョンを同時にインストールできない」 ことに。結果として、どちらかのプロジェクトが動かなくなってしまいます。
そこで、venvの出番です。 プロジェクトAには「A専用の開発環境」、プロジェクトBには「B専用の開発環境」を作成。そして、それぞれの開発環境に必要な道具(ライブラリ)を用意すれば、お互いに干渉せず、好きなライブラリを使うことができます。
各プロジェクトが独立した開発環境で動作するため、互いに影響を与えないのが大きなメリットです。
また、特定のバージョンのライブラリを使用する必要がある場合でも、仮想環境を利用することで簡単に管理できます。さらに、開発環境を簡単に再現できるため、チームでの開発やデプロイ時にも非常に便利です。
Python venvの使い方
venvを使って仮想環境を作成するのは、とても簡単です！
基本的には、
「作る」 → 「入る（有効化）」 → 「使う」 → 「出る」
の流れです。以下に、手順を追って説明しますね。
仮想環境を作る
ターミナル（WindowsならコマンドプロンプトやPowerShell）で、プロジェクトのフォルダに移動し、以下のコマンドを打ちます。
# Windows
python -m venv .venv
#linux
python3 -m venv .venvpython -m venv ：「仮想環境を作ってください」という命令。.venv は「仮想環境の名前」です。慣習として .venv や venv という名前がよく使われますが、好きな名前でOKです。
- windows
基本的にはpythonが Python3を指しているので「python」を使います。 - linux
環境によってはpythonがPython2を指している可能性があるため、確実にPython3を指す「python3」を使う方が安全です。
作成した仮想環境に入って、実際に作業できるようにします。
Windows
.venv\Scripts\Activate.ps1Linux
source .venv/bin/activate以下のように、 コマンドラインの先頭に (.venv) という表示が出れば成功です！ これで、作成した仮想環境が有効になります。
#例
(.venv) C:\Users\User\MyProject>後は、いつもと同じように作業しましょう。仮想環境を有効化した状態で pip install をすると、パソコン全体ではなく、その仮想環境の中だけに インストールされます。
pip install pandas作業を終えて仮想環境を出るときは、以下のコマンドを打ちます。
deactivateコマンドが成功すると、コマンドライン先頭の(.venv) という表示が消えます。これで、元の状態に戻りました。
仮想環境の削除と復元
上で説明した仮想環境は、気軽に作ったり消したりして大丈夫です。Python開発では、「環境がごちゃごちゃしてきたから、一回削除して作り直そう」 というのは、よくあることですよね。
ここでは、必要に応じて仮想環境を削除・復元する方法について説明します。
仮想環境の削除方法
作成した仮想環境（.venv などのフォルダ）を削除するのは簡単。特別な「削除コマンド」はありません。 ただのフォルダなので、「フォルダごとゴミ箱に捨てる」 だけで削除完了です。
手順は以下の2ステップです。
もし、現在その仮想環境に入っている状態（ターミナルに (.venv) が表示されている状態）なら、まずはそこから抜けます。
deactivate方法A：マウス操作で消す（一番かんたん）
エクスプローラーなどからプロジェクトフォルダ内の.venvフォルダ （フォルダ名が .venv の場合）を探して削除
これだけで完了です！きれいさっぱりなくなります。
方法B：コマンドで消す（慣れている人向け）
ターミナルからコマンド一発で消すこともできます。（フォルダ名が .venv の場合）
Windows
# フォルダの中身ごと強制削除するコマンド
rmdir /s /q .venvLinux
rm -rf .venv上のやり方で消えるのは、仮想環境フォルダ(.venv)とその中身だけです。
自分のプログラムは通常、.venvフォルダプロジェクトフォルダ直下）の外にあるはずなので、それらは消えずに残ります。
仮想環境の復元
仮想環境を復元するには、requirements.txtを使います。
requierments.txtは、いわば「プロジェクトで使うライブラリ(道具)のリスト」です。
このリストさえあれば、仮想環境を削除してしまっても、あるいは別のパソコンに移動しても、コマンド一発でまったく同じ環境を再現できます。
手順は「リストを作る（保存）」と「リストから復元する」の2つです。
まず、仮想環境が有効（(.venv)が表示されている状態）であることを確認してください。 その状態で、以下のコマンドを実行します。
pip freeze > requirements.txtpip freeze ： インストールされているライブラリとバージョンの一覧を表示させる。
> ： 表示された内容を、ファイルに書き込む記号（リダイレクト）。
requirements.txt ： 保存するファイル名（慣習としてこの名前が使われます）。
結果： フォルダの中に requirements.txt というファイルが生成されます。中身を見ると、以下のようにライブラリ名とバージョンがズラッと書かれています。
pandas==2.0.3
numpy==1.24.3
requests==2.31.0
...仮想環境を削除した後や、新しいメンバーがプロジェクトに参加した時は、以下の手順で一気に環境を再現します。
(1) 新しい仮想環境を作る (python -m venv .venv)
(2) 仮想環境を有効化する (Windowsなら Activate.ps1, Macなら source ...)
(3) リストを使って一括インストール
ここで、以下のコマンドを入力します。
pip install -r requirements.txt-r ： 「このファイルを読み込んで（read）、書いてあるものを全部インストールして」というオプションです。
これで、一つ一つインストールしなくても、リストに書かれた10個でも100個でものライブラリが、自動的に正しいバージョンでインストールされます。
Python venv：まとめ
本記事ではPythonのvenvの使い方について、基礎的な内容を中心に説明してきました。
チームでの開発や異なるバージョンのライブラリを使用する場合には、仮想環境が不可欠です。venvを使いこなして、より便利な開発環境を構築し、効率的に作業を進めていきましょう！
