1
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Python venv入門 Mac・Windowsの環境構築とactivate・deactivate

1
Last updated at Posted at 2026-09-30

はじめに

Python venv入門:Mac・Windowsでプロジェクト専用の環境を作るウェルナ

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を入れていない場合は、まず本体のインストールが必要です。

導入後はターミナルを開き直し、前の表のコマンドでバージョンが表示されることを確認します。

venvを作るときに指定したPythonが、その環境のもとになります。 たとえばPython 3.14で作りたいなら、先に3.14系が選ばれていることを確かめます。複数のPythonを入れている場合は、対応する実行ファイルやバージョン指定を使ってください。

Macに既にある古いPythonを、OS付属のものも含めて削除・上書きする必要はありません。開発用Pythonを用意し、どれを呼んでいるか確認する方が安全です。

4. 仮想環境を作成する

作業用フォルダを用意し、その中に.venvを作ります。ここでは、既存のファイルと混ざらないよう、新しいvenv-demoという名前を使います。既に同名フォルダがある場合は、別名にしてください。

Macの場合

Macのターミナル
mkdir venv-demo
cd venv-demo
python3 -m venv .venv

Windowsの場合

次の3行は、PowerShellとコマンドプロンプトのどちらでも使えます。

Windowsのターミナル
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

Macのターミナル
source .venv/bin/activate

sourceは、スクリプトの内容を 現在のシェルへ反映する 操作です。bash .venv/bin/activateのように別のシェルを起動して実行するのとは違います。

Windows:PowerShell

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が選ばれるようになります。

出典:Python公式:How venvs work。

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サーバーを停止する命令ではありません。必要なプログラムは、そのプログラムの停止方法に従って別途終了します。

出典:Python公式:How venvs work。

8. 翌日、同じ環境を使うには?

毎回作り直す必要はありません。 プロジェクトのフォルダへ移動し、再度有効化します。

たとえばMacなら、プロジェクトのフォルダで次を実行します。

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を使うか明示したいときにも役立ちます。

出典: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を明示します。

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がある場合は上書きせず、次の行が含まれているか確認します。

.gitignoreへの追記例
.venv/

Python 3.13以降では、venvが環境内にGit向けの.gitignoreを既定で作成します。それとは別に、プロジェクト側で.venv/を除外しておくと、意図が分かりやすくなります。既にGitへ追加済みのファイルは、.gitignoreを書くだけでは追跡対象から外れません。

出典:Python公式:venv、pip公式:pip freeze、Microsoft:about_Character_Encoding、Git公式:gitignore。

12. 仮想環境を削除・作り直す

venvには、環境の一覧を一括管理したり、削除したりする専用の基本コマンドはありません。不要になった環境は、そのフォルダを削除します。

初めてなら、次の順で進めると対象を確認しやすくなります。

  1. 必要な依存関係の記録を残します。
  2. その環境を使っているPythonプログラムを終了し、有効化していればdeactivateします。
  3. 削除対象が プロジェクト内の.venvだけ であることを確認します。
  4. Finderやエクスプローラーで、対象の.venvをゴミ箱へ移します。
  5. 必要なら、新しく環境を作成してパッケージを入れ直します。

自分で書いた.pyファイルを.venv内へ保存しない ことも大切です。ソースコードまで一緒に削除してしまわないよう、仮想環境の外に置きます。

コマンドで削除したい場合

次の操作はフォルダを再帰的に削除します。通常はゴミ箱へ入らず、簡単には戻せません。 現在地と対象を確認し、.venv以外へ対象を広げないでください。

Macでは、プロジェクトのフォルダで対象を確認してから実行します。

Macで対象確認後に仮想環境だけ削除する
pwd
ls -ld .venv
rm -r .venv

PowerShellでは、-WhatIfで対象を確認し、次のコマンドでは確認に答えて削除します。

PowerShellで対象確認後に仮想環境だけ削除する
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。表は、本文の操作をもとに筆者がまとめた確認順です。

まとめ

最初は、次の流れを覚えれば十分です。

  1. Python本体を確認する。
  2. プロジェクトごとに.venvを作る。
  3. 自分のOS・シェルに合ったコマンドで有効化する。
  4. python -m pipで、その環境のパッケージを管理する。
  5. 作業を終えたらdeactivateする。
  6. 次回は同じ.venvを再び有効化する。

作成・有効化・解除・削除は、別々の操作 です。この区別ができると、環境構築の手順を丸暗記しなくても、いま何をしているのかが分かるようになります。

おわりに

まずは学習用フォルダで環境を1つ作り、有効化前後のsys.executableを見比べてみてください。「どのPythonを動かしているか」を確認する習慣が、環境トラブルの切り分けに役立ちます。

Wealthy Designでは、エンジニアの学習や現場で使える技術情報を発信しています。会社の取り組みは、コーポレートサイトで紹介しています。

AWS・Web開発・AI活用のご相談や、採用・カジュアル面談については、Wealthy Design公式LINEでもお問い合わせいただけます。

1
2
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
2

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?