はじめに

Pythonのプロジェクトを進める際、複数のプロジェクトがそれぞれ異なる依存関係（パッケージやライブラリのバージョンなど）を持つことがあります。

このような場合、Pythonの仮想環境を利用することで、各プロジェクトごとに独立した環境を作成し、依存関係を効率的に管理できます。

本記事では、Pythonの仮想環境を構築する方法について、自分用の備忘録も兼ねて、体系的にまとめています。

Pythonの仮想環境とは？

仮想環境とは、Pythonやそのパッケージをプロジェクトごとに隔離して管理する仕組みのことです。仮想環境を活用することで、以下のようなメリットがあります。

さらに詳しい解説は、以下のサイトを参考にしてください。

ここでは、M1 MacBookを使用して仮想環境を構築します。

環境によって操作が異なる場合がありますので、ご自身のOSやPythonバージョンに応じて適宜対応してください。

仮想環境を構築する前に、Pythonがインストールされているか確認します。以下のコマンドをターミナルで実行してください。

python --version
# または
python3 --version

私の環境では、以下のようにバージョンが確認できました。

➜  Desktop git:(honda-branch) ✗ python --version 
Python 3.12.0

もしPythonがインストールされていない場合は、以下のリンクを参考にしてPythonをインストールしてください。

まず、仮想環境を作成するためのディレクトリを用意します。

Pythonの標準ライブラリである venv を使用して仮想環境を作成します。以下のコマンドでは、必要に応じて親ディレクトリ（projects）が存在しない場合、自動的に作成されます。

mkdir -p ~/projects/my_project

ディレクトリを作成したら、その中に移動します。

cd ~/projects/my_project

次に、以下のコマンドを実行して仮想環境を作成します。

python -m venv venv

※venv は仮想環境のディレクトリ名です。他の名前に変更することも可能です。

作成した仮想環境を有効化します。環境によって手順が異なりますので、以下を参照してください。

Linux/macOS:

source venv/bin/activate

Windows:

venv\Scripts\activate

有効化が成功すると、コマンドラインの先頭に仮想環境名（(venv)）が表示されます。

(venv) $

これで仮想環境が有効になり、以降の作業はこの仮想環境内で行われます。

仮想環境を有効にした状態で、必要なパッケージをインストールします。

例：requestsパッケージをインストール

以下のコマンドで requests パッケージをインストールできます。

pip install requests

さらに、依存関係を記録するために requirements.txt を作成しておくことをおすすめします。これにより、後から同じ環境を再現しやすくなります。

pip freeze > requirements.txt

作業が完了したら、仮想環境を無効化します。無効化することで、グローバル環境に戻ります。

deactivate

Pythonの仮想環境を使用することで、各プロジェクトごとの依存関係を安全かつ効率的に管理できます。

これにより、開発作業がスムーズになり、環境の衝突を防ぐことができます。

仮想環境はPython開発における基礎的なスキルの一つですので、ぜひ今回の記事を参考に、仮想環境を活用してプロジェクトを進めてみてください！

不要になった仮想環境は、以下のコマンドでディレクトリを削除するだけでOKです。

rm -rf venv

これにより、仮想環境を完全に削除できます。