「プロジェクトAでは古いDjangoが必要なのに、プロジェクトBでは最新版を使いたい」そんな悩みを解決するのがPythonの仮想環境です。venvは追加インストール不要で、軽量かつ全OSで同じ操作感。プロジェクト専用のライブラリ置き場を作ると、複数案件の並行開発も安心です。
本記事では、仮想環境が必要な理由から具体的な作成手順、チーム開発での活用法、PowerShellエラーなどのトラブル対処まで網羅的にご紹介します。実務ですぐ活かせる環境構築スキルを身につけてください。
Contents
Pythonの仮想環境（venv）とは
Pythonの仮想環境は、プロジェクト単位で独立したPython実行環境を用意する仕組みです。
venvを使うと、案件ごとに異なるライブラリやバージョンを分けて管理でき、環境の衝突を避けられます。
仮想環境の基本的な意味
仮想環境は、システムのPythonとは別に、専用のパッケージ置き場を用意した箱のようなものです。
pip installしたライブラリはその箱の中だけに入り、案件ごとに分けて管理できます。
なぜ仮想環境が必要なのか
仮想環境を使う主な理由は、ライブラリの競合を避け、プロジェクトごとの依存関係を明確にするためです。
requirements.txtを共有すれば、同じ環境を再現しやすくなります。
Pythonの仮想環境を作る方法
仮想環境を作成する方法をご説明します。
venvの特徴
venvはPython 3.3以降に標準搭載の仮想環境ツールです。
追加インストール不要で、軽量かつシンプルな構成が特徴です。
仮想環境の作成コマンド
| python -m venv 環境名 |
で仮想環境を作成します。
| # venvという名前で仮想環境を作成python -m venv venv# 作成後、venvフォルダ内にPython本体・pip・ライブラリ用フォルダが生成される# プロジェクト直下に作成すると管理しやすい |
仮想環境の有効化と無効化
作成後、有効化の操作で仮想環境を使用できます。
| # Windowsコマンドプロンプトvenv\Scripts\activate # Windows PowerShell.\venv\Scripts\Activate.ps1 # macOS・Linuxsource venv/bin/activate |
有効化すると、端末の先頭に(venv)と環境名が表示されます。
| # 作業が終わったら、以下のコマンド（OS共通）で無効化しますdeactivate# 仮想環境が不要になったら、無効化後にフォルダごと削除できます |
仮想環境でできること
本項では、仮想環境で実現できる主な機能を詳しく解説します。
ライブラリのインストール管理
仮想環境を有効化すると、pip installで入れたライブラリはその環境専用になります。
| # requestをインストールpip install requests # インストール済みライブラリの一覧表示pip list # 特定のライブラリの詳細情報を表示pip show requests # バージョンを指定してインストールpip install requests==2.32.3 |
requirements.txtの作成
requirements.txtは使用するライブラリとバージョンを記録し、開発環境を再現する際に使います。
| # requirements.txtを作成pip freeze > requirements.txt |
作成されたrequirements.txtの例:
| requests==2.32.3numpy==2.2.6pandas==2.2.3 |
Gitで共有すれば、案件の引き継ぎや納品時にも環境条件を明確に伝えられます。
別環境での再現性確保
新しい環境・サーバーで同じ環境を再現したい場合は、仮想環境を有効化し下記を実行します。
| # requirements.txtから一括インストールpip install -r requirements.txt |
venv以外の仮想環境ツール
代表的な他の仮想環境ツールを2つご紹介します。
Anaconda / conda
データサイエンスに特化したディストリビューションです。
condaはnumpyなどの重いライブラリも管理しやすく、環境ごとにPythonのバージョンも切り替えられます。
pyenv + venv
pyenvは複数のPythonバージョンをインストールし切り替えるツールです。下記のような要件に1台のパソコンで対応できます。
| # プロジェクト要件の例・プロジェクトA: Python 3.10 + Django 4.2・プロジェクトB: Python 3.13 + Django 5.1 |
macOSではHomebrewからpyenvを導入できます。
| brew update# pyenv自体のインストールbrew install pyenv# Pythonビルドに必要なツールの導入brew install openssl readline sqlite3 xz tcl-tk@8 libb2 zstd zlib pkgconfig # 特定バージョンのPythonを導入pyenv install 3.10 |
詳しい導入手順はpyenv公式リポジトリを参照ください。
| # プロジェクトディレクトリへ移動cd myproject# プロジェクトで使用するPythonバージョンを指定pyenv local 3.10# 仮想環境を作成（Python 3.10を使用）python -m venv venv |
まとめ
Pythonの仮想環境（venv）は、プロジェクトごとに独立した実行環境を構築し、ライブラリの競合を防ぐ仕組みです。標準搭載で軽量と扱いやすい特徴があります。
ご紹介した作成手順と管理方法を参考に、ぜひ次のプロジェクトから仮想環境を導入してみてください。
フリーランスの案件をお探しの方はTechReachにご相談ください。
TechReachを運営する株式会社アールストーンはIT・Web業界特化で15年以上の実績がございます。
そのため、高単価・高品質な数多くの案件紹介が可能です。
また一人のコンサルタントが企業と求職者様の担当を行う「両面型エージェント」を採用しているため、あなたの希望に合う案件がきっと見つかるはずです。
TechReachを活用して、理想の案件を見つけましょう！
