はじめに
Pythonで開発をしていると、「あれ、このライブラリ、別のプロジェクトで使ったバージョンと違うな...」という問題に直面することがあります。そんな時、プロジェクトごとに独立した環境を作るのが**「仮想環境(Virtual Environment)」**です。この記事では、なぜ仮想環境が必要なのか、そしてその簡単な作り方について解説します。
なぜ仮想環境が必要なのか?
想像してみてください。あなたは今、2つのプロジェクトを抱えています。
- プロジェクトA:Python 3.8で開発されており、ライブラリXのバージョン1.0が必要です。
- プロジェクトB:Python 3.10で開発されており、ライブラリXのバージョン2.0が必要です。
もし仮想環境を使わずにこれらのプロジェクトを進めると、システム全体にインストールされたライブラリXのバージョンが衝突し、どちらかのプロジェクトが動かなくなる可能性があります。
仮想環境は、プロジェクトごとに**独立した「部屋」**を作るようなものです。それぞれの部屋に、必要なPythonのバージョンやライブラリをインストールできるため、他のプロジェクトに影響を与えることなく開発を進められます。
Pythonの仮想環境を作る前に、Pythonが正しくインストールされているかを確認しましょう。
python --versionコマンドとは?
このコマンドは、お使いのコンピューターにインストールされているPythonのバージョンを表示します。例えば、「Python 3.10.4」のように表示され、現在どのバージョンが使えるかを示します。
なぜ仮想環境作成前に確認が必要?
Pythonのインストール確認: コマンドを実行してバージョンが表示されなければ、Pythonがインストールされていません。まずはインストールが必要です。
プロジェクトの要件: プロジェクトによっては、特定のPythonバージョンが必要です。現在のバージョンを知ることで、要件を満たしているか判断できます。
仮想環境のベース: 仮想環境を作る際、どのPythonバージョンを基にするか選ぶことがあります。グローバルなバージョンを把握しておくと、この選択がスムーズになります。
仮想環境作成前のチェックリスト ✅
Pythonのインストール: python --versionコマンドで、バージョンが表示されることを確認します。
pipの確認: パッケージ管理ツールのpipも使えるか、pip --versionコマンドで確認しておきましょう。
これらの確認ができたら、いよいよ仮想環境の作成に進めます!
仮想環境の作り方(Windows・macOS共通)
Python 3.3以降では、標準ライブラリとしてvenvという仮想環境作成ツールが組み込まれています。特別なツールのインストールは不要です。
1. プロジェクト用のディレクトリを作成する
まずは、仮想環境を作成したい場所に新しいフォルダを作ります。
mkdir my-project
cd my-project
2. 仮想環境を作成する
以下のコマンドを実行して、venvという名前の仮想環境を作成します。
python -m venv venv
このコマンドは、現在のディレクトリにvenvという名前のフォルダを作成し、その中に独立したPython環境を構築します。venvの部分は任意の名前(例: .venv, my_envなど)に変更できます。
3. 仮想環境を有効化する
仮想環境を使い始めるには、有効化(Activate)する必要があります。
-
Windowsの場合
.\venv\Scripts\activate -
macOS / Linuxの場合
source venv/bin/activate
コマンドプロンプトやターミナルの左端に(venv)のような表示が出れば成功です。これで、この環境内でpip installを実行すると、ライブラリは仮想環境の中にだけインストールされます。
4. 仮想環境を無効化する
作業を終えるときは、以下のコマンドで仮想環境を無効化(Deactivate)します。
deactivate