はじめに
Pythonの手順を読むと、よく次のような説明が出てきます。
「まずvenvを作って、activateしてください。終わったらdeactivateします」
初めてだと、「Pythonは入れたのに、なぜ別の環境が必要なのか」「deactivateするとインストールしたものが消えるのか」が分かりにくいところです。
この記事では、仮想環境の意味とメリットから、作成・有効化・パッケージ追加・解除・作り直しまでを説明します。MacとWindowsのコマンドの違いも整理します。
先に結論
- venv は、プロジェクトごとにPythonの追加パッケージを分けるための標準機能です。
- 作成 は環境の入れ物を用意する操作、 activate は今のターミナルでその環境を使いやすくする操作です。
- deactivate は有効化を解除する操作です。環境やパッケージは削除されません。
- MacとWindowsでは、主に「有効化コマンド」と「環境内の実行ファイルの場所」が異なります。
- 有効化した後は、
python -m pipを使うと、どのPythonへパッケージを入れるかが明確になります。
前提と確認環境
- 対象は、Pythonをこれから使う人、環境構築のコマンドを意味から理解したい人です。
- Macは標準的なターミナルのzsh/bash、WindowsはPowerShellまたはコマンドプロンプトを想定します。
- 公式資料と実行結果の確認日は 2026年9月30日 です。Python 3.14系の資料を中心に確認しています。
- Mac側の主要操作は、macOS 26.6.2/Apple Silicon/Python 3.14.6/zsh 5.9で実行しました。
- Windows側はGitHub Actionsの Windows Server 2025仮想マシン で、Python 3.14.6/Windows PowerShell 5.1/PowerShell 7.6.6/コマンドプロンプトを使って実行しました。作成、有効化、pipでの追加、解除、直接実行、requirements.txtからの再構築が成功しています。検証結果と実行コードを参照できます。
- Windows 10/11の個人PC、Python本体のインストール操作、実行ポリシーの変更は今回実行していません。インストール方法や組織の設定に合わせて調整してください。
- Conda、uv、Poetry、Dockerの詳しい比較や、本番サーバーへの配置は扱いません。
コマンドは、Pythonの対話画面に出る>>>ではなく、 OSのターミナル に入力します。>>>が出ている場合は、exit()でPythonの対話画面を終了してください。
1. venvとは? プロジェクト専用の「道具箱」
Python本体は、Pythonのコードを実行するプログラムです。一方、HTTP通信やデータ分析などの機能を追加するために、外部の パッケージ を入れることがあります。
パッケージを取得・インストールする代表的なツールが pip です。
ここで、すべてのプロジェクトが同じ追加パッケージを使っていると困ることがあります。
たとえば、プロジェクトAではあるライブラリの旧バージョンが必要なのに、プロジェクトBのために更新した結果、Aが動かなくなるケースです。
venvで仮想環境を分けると、A用とB用に、それぞれ必要なパッケージを入れられます。 プロジェクトごとに道具箱を持つ イメージです。
Python公式のvenvの説明を踏まえると、主なメリットは次のように整理できます。道具箱の比喩と表は、学習用に筆者がまとめたものです。
| メリット | 何が助かるか |
|---|---|
| プロジェクト間の影響を減らせる | AとBで、異なるバージョンのパッケージを使いやすい |
| 共用のPython環境へ追加せずに済む | 学習用パッケージをプロジェクト内の環境にまとめられる |
| 必要なパッケージを把握しやすい | 専用環境なので、別の学習で入れたものが混ざりにくい |
| 作り直しやすい | 必要な情報を残しておけば、仮想環境だけを作り直せる |
venvは、既にインストールされているPythonをもとに環境を作ります。 別のバージョンのPython本体をダウンロードする機能ではありません。
また、分けられるのは主にPythonのパッケージ環境です。 仮想マシンではなく、安全性を保証する隔離空間でもありません。 仮想環境内のプログラムでも、実行ユーザーの権限でファイルやネットワークにアクセスできます。出所の分からないコードを安全にする機能ではない点に注意してください。
2. MacとWindowsの違いを先に整理する
以下は、Python公式の有効化コマンド一覧をもとに、環境名を.venvへ統一した早見表です。
コマンドは、プロジェクトのフォルダに移動してから実行します。
| 操作 | Mac:zsh/bash | Windows:PowerShell | Windows:コマンドプロンプト |
|---|---|---|---|
| Pythonの確認 | python3 --version |
py --version |
py --version |
| 仮想環境の作成 | python3 -m venv .venv |
py -m venv .venv |
py -m venv .venv |
| 有効化 | source .venv/bin/activate |
.\.venv\Scripts\Activate.ps1 |
.venv\Scripts\activate.bat |
| 有効化後のPython確認 | python --version |
python --version |
python --version |
| pipの場所を確認 | python -m pip --version |
python -m pip --version |
python -m pip --version |
| 有効化を解除 | deactivate |
deactivate |
deactivate |
Windowsでは、インストール方法によってpyではなくpythonを使う場合があります。python --versionで目的のPythonが確認できるなら、作成コマンドをpython -m venv .venvに置き換えられます。
Windows Terminalはターミナルを表示するアプリの名前 です。そのタブでPowerShellを使っているのか、コマンドプロンプトを使っているのかでコマンドを選びます。WSLはLinux環境なので、Windows用のScriptsではなく、Linux側のPythonとbinを使います。Windows側とWSL側で同じ仮想環境を共有しないでください。
3. 最初にPython本体を確認する
まだPythonを入れていない場合は、まず本体のインストールが必要です。
- Mac:Python公式のmacOS向けダウンロードとmacOSでの利用案内を確認します。
- Windows:現在の公式案内では Python Install Manager を使う方法が紹介されています。Windowsでの利用案内に従って導入します。旧来のインストーラーを使っている場合とは手順が異なることがあります。
導入後はターミナルを開き直し、前の表のコマンドでバージョンが表示されることを確認します。
venvを作るときに指定したPythonが、その環境のもとになります。 たとえばPython 3.14で作りたいなら、先に3.14系が選ばれていることを確かめます。複数のPythonを入れている場合は、対応する実行ファイルやバージョン指定を使ってください。
Macに既にある古いPythonを、OS付属のものも含めて削除・上書きする必要はありません。開発用Pythonを用意し、どれを呼んでいるか確認する方が安全です。
4. 仮想環境を作成する
作業用フォルダを用意し、その中に.venvを作ります。ここでは、既存のファイルと混ざらないよう、新しいvenv-demoという名前を使います。既に同名フォルダがある場合は、別名にしてください。
Macの場合
mkdir venv-demo
cd venv-demo
python3 -m venv .venv
Windowsの場合
次の3行は、PowerShellとコマンドプロンプトのどちらでも使えます。
mkdir venv-demo
cd venv-demo
py -m venv .venv
python3 -m venv .venvは、次の意味です。
| 部分 | 意味 |
|---|---|
python3 |
環境を作るために使うPython |
-m venv |
そのPythonのvenvモジュールを実行する |
.venv |
作成先のフォルダ名 |
.venvは特別な予約語ではありません。別名でも作れますが、プロジェクト専用の仮想環境だと分かりやすいため、この記事ではこの名前に統一します。
Macでは先頭が.のフォルダは通常非表示です。Finderで見つからなくても、作成に失敗したとは限りません。
ここまでで 環境は作成されましたが、今のターミナルではまだ有効化していません。
出典:Python公式:Creating virtual environments。
5. activateで仮想環境を有効化する
.venvを作ったプロジェクトのフォルダで、自分のOS・シェルに合うコマンドを実行します。
Mac:zsh/bash
source .venv/bin/activate
sourceは、スクリプトの内容を 現在のシェルへ反映する 操作です。bash .venv/bin/activateのように別のシェルを起動して実行するのとは違います。
Windows:PowerShell
.\.venv\Scripts\Activate.ps1
Windows:コマンドプロンプト
.venv\Scripts\activate.bat
有効化すると、入力行の先頭に(.venv)のような表示が付くことがあります。ただし、表示はターミナルの設定にもよるため、見た目だけで判断しない方が確実です。
本当にその環境を使っているか確認する
有効化後は、各OSで次のコマンドを使えます。
python -c "import sys; print(sys.executable); print(sys.prefix != sys.base_prefix)"
python -m pip --version
- 1行目の出力には、
.venv/bin/pythonまたは.venv\Scripts\python.exeを含むパスが表示されます。 - 続けて
Trueが出れば、そのPythonは仮想環境内で動いています。 - pipの表示先も
.venv内になっていることを確認します。
python -cは、短いPythonコードをその場で実行するための指定です。
activateは、主に コマンドの検索先を並べたPATHへ、仮想環境の実行ファイル置き場を先頭に追加する 操作です。そのため、有効化後にpythonと入力すると、その環境のPythonが選ばれるようになります。
6. パッケージを入れて使ってみる
仮想環境が有効になっている状態で、HTTP通信ライブラリのrequestsを入れてみます。インターネット接続が必要です。
python -m pip install requests
python -c "import requests; print(requests.__version__)"
python -m pip check
検証時は、バージョン表示が2.34.2、依存関係の確認結果がNo broken requirements found.でした。インストールされるバージョンは、実行時点や環境によって変わります。この例では、外部のWebサイトへのHTTPリクエストは送っていません。
python -m pipは、 今使っているPythonでpipを実行する 書き方です。単にpipと入力するよりも、Pythonとpipの組み合わせを意識しやすくなります。ただし、間違ったPythonを選んでいれば、そのPythonに対して操作するため、前の節の確認も重要です。
出典:pip公式:User Guide、pip check。
よく使うpipコマンド
| やりたいこと | 有効化後のコマンド |
|---|---|
| インストール済み一覧を見る | python -m pip list |
| requestsの詳細・場所を見る | python -m pip show requests |
| パッケージの依存関係を検査する | python -m pip check |
| requestsを削除する | python -m pip uninstall requests |
uninstallは、現在選んでいるPython環境から指定パッケージを削除します。実行前に環境を確認し、削除対象を確認する問いには内容を読んで答えてください。依存先として一緒に入った別のパッケージまで、自動でまとめて消えるわけではありません。
7. deactivateで仮想環境から抜ける
作業を終えるときは、Mac・Windowsともに、 有効化したのと同じターミナル で次を実行します。
deactivate
ここが特に混同しやすいところです。
| 操作 |
.venvフォルダ |
インストールしたパッケージ | 今のターミナル |
|---|---|---|---|
deactivate |
残る | 残る | 有効化を解除する |
.venvフォルダの削除 |
消える | その環境内のものは消える | 先に有効化を解除しておく |
deactivateは、道具箱を捨てる操作ではなく、いったん使うのをやめる操作 です。
解除後のpythonコマンドは、元の検索先に戻ります。Macなどでは、元の環境にpythonという名前のコマンドがなく、command not foundになることもあります。仮想環境が壊れたという意味ではありません。
また、deactivateは、既に起動しているPythonプログラムやWebサーバーを停止する命令ではありません。必要なプログラムは、そのプログラムの停止方法に従って別途終了します。
8. 翌日、同じ環境を使うには?
毎回作り直す必要はありません。 プロジェクトのフォルダへ移動し、再度有効化します。
たとえばMacなら、プロジェクトのフォルダで次を実行します。
source .venv/bin/activate
python -m pip list
Windowsでは、前述のActivate.ps1またはactivate.batを使います。
有効化は、基本的に そのターミナルのセッション単位 です。別のタブや新しいターミナルにも、自動で反映されるとは限りません。IDEが自動で有効化する場合もありますが、分からなくなったらsys.executableで確認してください。
9. activateしなくても使える
実は、有効化は仮想環境を使うための必須操作ではありません。 仮想環境内のPythonをパスで直接指定 しても使えます。
Mac
.venv/bin/python -m pip list
.venv/bin/python -c "import sys; print(sys.prefix != sys.base_prefix)"
Windows:PowerShell/コマンドプロンプト
.\.venv\Scripts\python.exe -m pip list
.\.venv\Scripts\python.exe -c "import sys; print(sys.prefix != sys.base_prefix)"
この方法でも、仮想環境内のPythonを使っていればTrueになります。有効化していないので、その操作の後にdeactivateする必要はありません。
自動実行や、どのPythonを使うか明示したいときにも役立ちます。
10. Windowsで「スクリプトの実行が無効」と出たら
PowerShellでActivate.ps1が拒否される場合は、 実行ポリシー が関係している可能性があります。
まず、設定を変えずに、前の節の.\.venv\Scripts\python.exeを直接使う方法を検討してください。これはActivate.ps1を実行しない方法であり、組織のソフトウェア利用制限を回避してよいという意味ではありません。
個人管理のPCなどで、設定変更が許されている場合に限り、現在のPowerShellセッションだけを対象にする例は次のとおりです。
Get-ExecutionPolicy -List
Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned
.\.venv\Scripts\Activate.ps1
Processは現在のセッションを対象とし、そのセッションを終了すると設定は失われます。RemoteSignedにも実行条件があり、インターネット由来のスクリプトなどが無条件に許可されるわけではありません。
会社のPCでは、管理者のルールを優先してください。グループポリシーで定められた設定は優先されます。動かないからといって、BypassやUnrestrictedへ安易に変更しないでください。
出典:Microsoft:about_Execution_Policies。
11. requirements.txtで、入れたパッケージを記録する
.venvフォルダそのものを、別のPCへコピーして使い回すことは勧められていません。パスやOS、Python本体などに依存するため、 移動先で作り直す のが基本です。
そこで、インストール済みパッケージを記録する例としてrequirements.txtを使います。以下は、目的の仮想環境を有効化した状態で実行します。
次の保存コマンドは、既存のrequirements.txtを上書きします。チームで管理しているファイルには無断で実行せず、ここでは新しく作った学習用フォルダで試してください。
Mac/Windowsのコマンドプロンプト
python -m pip freeze > requirements.txt
WindowsのPowerShell
Windows PowerShell 5.1と新しいPowerShellでは、ファイル出力の既定の文字コードに違いがあります。ここではUTF-8を明示します。
python -m pip freeze | Set-Content -Encoding utf8 requirements.txt
この指定では、Windows PowerShell 5.1はBOM付きUTF-8、PowerShell 7はBOMなしUTF-8になります。今回の検証では、どちらのファイルからもpip install -r requirements.txtで環境を再構築できました。文字コードの違いはMicrosoftの公式説明も確認してください。
保存した内容は、エディターで開いて確認できます。今回の検証ではrequests==2.34.2に加え、requestsが必要とする他のパッケージも記録されました。
新しい環境を作成・有効化してから、同じファイルを使って次のようにインストールできます。
python -m pip install -r requirements.txt
python -m pip check
ただし、pip freezeは インストール済みの内容を出力するコマンド であり、異なるOSやPythonバージョンでも同じ動作を保証する仕組みではありません。Python本体のバージョン、OS依存のライブラリなども別途確認が必要です。厳密な依存関係管理やロックファイルの設計は、次の学習テーマです。
また、Gitで共有するのはソースコードや必要な依存関係の情報であり、通常.venvそのものは共有しません。既存の.gitignoreがある場合は上書きせず、次の行が含まれているか確認します。
.venv/
Python 3.13以降では、venvが環境内にGit向けの.gitignoreを既定で作成します。それとは別に、プロジェクト側で.venv/を除外しておくと、意図が分かりやすくなります。既にGitへ追加済みのファイルは、.gitignoreを書くだけでは追跡対象から外れません。
出典:Python公式:venv、pip公式:pip freeze、Microsoft:about_Character_Encoding、Git公式:gitignore。
12. 仮想環境を削除・作り直す
venvには、環境の一覧を一括管理したり、削除したりする専用の基本コマンドはありません。不要になった環境は、そのフォルダを削除します。
初めてなら、次の順で進めると対象を確認しやすくなります。
- 必要な依存関係の記録を残します。
- その環境を使っているPythonプログラムを終了し、有効化していれば
deactivateします。 - 削除対象が プロジェクト内の
.venvだけ であることを確認します。 - Finderやエクスプローラーで、対象の
.venvをゴミ箱へ移します。 - 必要なら、新しく環境を作成してパッケージを入れ直します。
自分で書いた.pyファイルを.venv内へ保存しない ことも大切です。ソースコードまで一緒に削除してしまわないよう、仮想環境の外に置きます。
コマンドで削除したい場合
次の操作はフォルダを再帰的に削除します。通常はゴミ箱へ入らず、簡単には戻せません。 現在地と対象を確認し、.venv以外へ対象を広げないでください。
Macでは、プロジェクトのフォルダで対象を確認してから実行します。
pwd
ls -ld .venv
rm -r .venv
PowerShellでは、-WhatIfで対象を確認し、次のコマンドでは確認に答えて削除します。
Get-Location
Remove-Item -LiteralPath .\.venv -Recurse -WhatIf
Remove-Item -LiteralPath .\.venv -Recurse -Confirm
コマンドプロンプトでは、/qを付けず、確認を残します。
cd
dir /a .venv
rmdir /s .venv
PowerShellの-WhatIfと検証専用環境の削除は、Windows Server 2025の仮想マシンで確認しました。ただし、掲載例の対話的な確認への応答、コマンドプロンプトの削除例、Windows 10/11の個人PCでは未検証です。フォルダが使用中で拒否された場合は、アプリやプロセスを確認し、強制削除を先に試さないでください。
作り直す場合は、新しい.venvを作成・有効化してからpython -m pip install -r requirements.txtを実行します。作成済みの環境へ、目的なくpython -m venv .venvを繰り返す必要はありません。
出典:Python公式:venvの削除・再作成の考え方、Microsoft:Remove-Item、Microsoft:rmdir。削除前の確認手順は筆者の整理です。
13. よくあるつまずき
| 症状・疑問 | 最初に見ること |
|---|---|
python3やpyが見つからない |
Python本体の導入、ターミナルの開き直し、コマンド名を確認する |
activateのファイルが見つからない |
今いるフォルダ、環境名、MacのbinとWindowsのScriptsの違いを確認する |
インストールしたのにModuleNotFoundError
|
sys.executableとpython -m pip --versionで、実行とインストールが同じ環境か確認する |
| PowerShellで有効化が拒否される | 実行ポリシーと組織のルールを確認する。許可された範囲で直接Pythonを呼ぶ方法も検討する |
deactivateが見つからない |
今のターミナルでは有効化していない、または別のタブで操作していないか確認する |
cdで別のプロジェクトへ移動した |
移動しただけで仮想環境が切り替わるとは限らない。解除してから、目的の環境を有効化する |
Macで作った.venvがWindowsで動かない |
コピーして共有せず、Windows側で環境を作り直す |
externally-managed-environmentと出た |
共用のPythonへ入れようとしていないか確認する。仮想環境のPythonでpipを実行する |
externally-managed-environmentは、OSやパッケージ管理ツールが管理するPython環境を、別のツールで変更しないための仕組みに関係します。原因を確認せずにsudo pipや--break-system-packagesで押し切らないようにします。
出典:PyPA:Externally Managed Environments。表は、本文の操作をもとに筆者がまとめた確認順です。
まとめ
最初は、次の流れを覚えれば十分です。
- Python本体を確認する。
- プロジェクトごとに
.venvを作る。 - 自分のOS・シェルに合ったコマンドで有効化する。
-
python -m pipで、その環境のパッケージを管理する。 - 作業を終えたら
deactivateする。 - 次回は同じ
.venvを再び有効化する。
作成・有効化・解除・削除は、別々の操作 です。この区別ができると、環境構築の手順を丸暗記しなくても、いま何をしているのかが分かるようになります。
おわりに
まずは学習用フォルダで環境を1つ作り、有効化前後のsys.executableを見比べてみてください。「どのPythonを動かしているか」を確認する習慣が、環境トラブルの切り分けに役立ちます。
Wealthy Designでは、エンジニアの学習や現場で使える技術情報を発信しています。会社の取り組みは、コーポレートサイトで紹介しています。
AWS・Web開発・AI活用のご相談や、採用・カジュアル面談については、Wealthy Design公式LINEでもお問い合わせいただけます。

