はじめに
JavaからPythonを勉強中、Javaにはなかった「アクティベート」という概念についてまとめました。
目次
1. アクティベートとは(概要)
-
モジュール(外部モジュール)を使うために必要な操作
- コマンドライン上で実行。
- モジュールを使わない単純なスクリプトの場合はそのまま実行可能。
- 処理中に外部モジュール(ライブラリ)を使う場合は、事前にアクティベートが必要。
-
プロジェクトごとに個別の環境を作る
- 作成単位はプロジェクト単位。
- プロジェクトAとプロジェクトBで、それぞれ独立した環境を用意する。
2. なぜ仮想環境が必要なのか?
Pythonは標準の状態だと、インストールしたモジュールがPC全体(グローバル)で共有されてしまいます。
そのため、以下のような問題を防ぐためにプロジェクトごとに作成した仮想環境(アクティベート)を使います。
- プロジェクトごとに「使いたいライブラリのバージョンが違う」ときにバッティングするのを防ぐ
- 不要なパッケージで環境が汚染されるのを防ぐ
3. 基本コマンド一覧
主要なコマンドは以下の通りです(Windowsの例)。
仮想環境の作成
python -m venv フォルダ名
仮想環境に入る(アクティベート)
# コマンドプロンプト(cmd)を使っている場合:
フォルダ名\Scripts\activate
# PowerShellを使っている場合:
フォルダ名\Scripts\Activate.ps1
仮想環境を出る(デアクティベート)
deactivate
4. 具体的な使用例(仮想環境の作成~プロジェクトの切り替え)
実際に、「Aプロジェクト」の仮想環境を作成・アクティベートし、「Bプロジェクト」の仮想環境へ切り替える一連の流れを見ていきます。
【前提条件】
- Aの仮想環境:未作成
- Bの仮想環境:作成済み
① Aプロジェクトの仮想環境を作成・アクティベートする
もし「Aという仮想環境フォルダがすでに存在するかどうか」不安な場合は、作成前に確認することができます。
存在確認# フォルダ内を確認する(Windows) dir A
- 未作成の場合: 「ファイルが見つかりません」と表示されます。
未作成_出力結果例ボリューム ラベルは Windows です ボリューム シリアル番号は XXXX-XXXX です C:\Users\YourName\Work のディレクトリ ファイルが見つかりません
- 作成済みの場合: pyvenv.cfg や Scripts フォルダが表示されます。
作成済み_出力結果例ドライブ C のボリューム ラベルは Windows です ボリューム シリアル番号は XXXX-XXXX です C:\Users\YourName\Work\A のディレクトリ 2026/10/15 11:30 <DIR> . 2026/10/15 11:30 <DIR> .. 2026/10/15 11:30 <DIR> Include 2026/10/15 11:30 <DIR> Lib 2026/10/15 11:30 112 pyvenv.cfg 2026/10/15 11:30 <DIR> Scripts 1 個のファイル 112 バイト 5 個のディレクトリ 123,456,789,012 バイトの空き領域
上記の確認後、今回はAプロジェクトが未作成という前提で、仮想環境の作成と有効化を行います。
# 1.Aの仮想環境の作成
python -m venv A
# 2. Aの仮想環境に入る
A\Scripts\activate
② 別プロジェクト(B)へ切り替えるときの注意点
まず現在開いているAプロジェクトの仮想環境をディアクティベートします。
# Aの仮想環境を出る
deactivate
【重要】Aの deactivate をしないまま、Bの activate をすると…
エラーは発生しないものの、モジュールをインストールした際に
「別のプロジェクト(別環境)に不要なパッケージが入ってしまう」という環境の混同が起きます。
→ プロジェクトを切り替える時は、必ず事前に deactivate を挟むこと!
Bプロジェクトの仮想環境をアクティベートして切り替え完了です。
# Bの仮想環境に入る
B\Scripts\activate
Bプロジェクトの作業完了後も下記で仮想環境をディアクティベートします。
# Bの仮想環境を出る
deactivate
補足:仮想環境の終了について
以下の操作を行った場合も、仮想環境は自動で終了(解除)されます。
- コマンドライン(ターミナル)のウィンドウを閉じる
- PCをシャットダウンする