Python仮想環境venvの使い方｜環境構築エラーを避ける設定手順

[コマンド名] -m venv [仮想環境用フォルダのパス（相対パス or 絶対パス）]
または
[コマンド名] [Pythonバージョン] -m venv [仮想環境用フォルダのパス（相対パス or 絶対パス）]

:::note
仮想環境用フォルダは、よく「venv」や「.venv」という名前で作成する例が多いです。

Windowsでは、「.venv」のように先頭に「ピリオド（.）」が付いたフォルダは隠しフォルダと見なされます。

エクスプローラーでは、「隠しフォルダを表示する」ようにしていないと当該フォルダが表示されませんので、ご注意ください。
:::
ので、ご注意ください。
:::

#### 実行例

##### 仮想環境用フォルダを相対パスで指定する場合

例）現在のフォルダに「venv」という仮想環境用フォルダを作成する

pyコマンドの場合）

![仮想環境用フォルダを相対パスで指定する場合（pyコマンドの場合）の画面キャプチャ](./image-5.png)

![仮想環境用フォルダを相対パスで指定する場合（pyコマンドの結果）の画面キャプチャ](./image-6.png)

![仮想環境用フォルダを相対パスで指定する場合（pyコマンドの結果のpython実行ファイル）の画面キャプチャ](./image-13.png)

![仮想環境用フォルダを相対パスで指定する場合（pyコマンドの結果のpython実行ファイルのバージョン確認）の画面キャプチャ](./image-14.png)

pythonコマンドの場合）

![仮想環境用フォルダを相対パスで指定する場合（pythonコマンドの場合）の画面キャプチャ](./image-7.png)

![仮想環境用フォルダを相対パスで指定する場合（pyコマンドの結果）の画面キャプチャ](./image-8.png)

![仮想環境用フォルダを相対パスで指定する場合（pythonコマンドの結果のpython実行ファイル）の画面キャプチャ](./image-15.png)

![仮想環境用フォルダを相対パスで指定する場合（pythonコマンドの結果のpython実行ファイルのバージョン確認）の画面キャプチャ](./image-16.png)

##### 仮想環境用フォルダを絶対パスで指定する場合

例）「D:\\test」フォルダに「venv」という仮想環境用フォルダを作成する

pyコマンドの場合）

![仮想環境用フォルダを絶対パスで指定する場合（pyコマンドの場合）の画面キャプチャ](./image-9.png)

![仮想環境用フォルダを絶対パスで指定する場合（pyコマンドの結果）の画面キャプチャ](./image-10.png)

![仮想環境用フォルダを絶対パスで指定する場合（pyコマンドの結果のpython実行ファイル）の画面キャプチャ](./image-17.png)

![仮想環境用フォルダを絶対パスで指定する場合（pyコマンドの結果のpython実行ファイルのバージョン確認）の画面キャプチャ](./image-18.png)

pythonコマンドの場合）

![仮想環境用フォルダを絶対パスで指定する場合（pythonコマンドの場合）の画面キャプチャ](./image-11.png)

![仮想環境用フォルダを絶対パスで指定する場合（pythonコマンドの結果）の画面キャプチャ](./image-12.png)

![仮想環境用フォルダを絶対パスで指定する場合（pythonコマンドの結果のpython実行ファイル）の画面キャプチャ](./image-19.png)

![仮想環境用フォルダを絶対パスで指定する場合（pythonコマンドの結果のpython実行ファイルのバージョン確認）の画面キャプチャ](./image-20.png)

##### 仮想環境で使うPythonのバージョンを指定する場合

例）現在のフォルダに「.venv」というPython 3.10仮想環境用フォルダを作成する

pyコマンドの場合）

![仮想環境で使うPythonのバージョンを指定する場合（pyコマンドの場合）の画面キャプチャ](./image-21.png)

![仮想環境で使うPythonのバージョンを指定する場合（pyコマンドの結果）の画面キャプチャ](./image-22.png)

![仮想環境で使うPythonのバージョンを指定する場合（pyコマンドの結果のpython実行ファイル）の画面キャプチャ](./image-23.png)

![仮想環境で使うPythonのバージョンを指定する場合（pyコマンドの結果のpython実行ファイルのバージョン確認）の画面キャプチャ](./image-24.png)

Python実行ファイルの場合）

:::caution
pythonコマンドではバージョンを指定できません。

対象バージョンのPython実行ファイルを直接実行すれば作成できます。
:::

![仮想環境で使うPythonのバージョンを指定する場合（python実行ファイル実行の場合）の画面キャプチャ](./image-25.png)

![仮想環境で使うPythonのバージョンを指定する場合（python実行ファイル実行の結果）の画面キャプチャ](./image-26.png)

![仮想環境で使うPythonのバージョンを指定する場合（python実行ファイル実行の結果のpython実行ファイル）の画面キャプチャ](./image-27.png)

![仮想環境で使うPythonのバージョンを指定する場合（python実行ファイル実行の結果のpython実行ファイルのバージョン確認）の画面キャプチャ](./image-28.png)

:::tip
Python実行ファイルを直接実行する場合のコマンドの先頭に書いてある「&（アンパサンド）」は、「呼び出し演算子（Call operator）」と言います。

「スクリプトを実行して結果だけ欲しい」場合に使います。スクリプトを実行して定義された変数や関数は実行後に残りません。

他にも先頭に「.（ドット）」を書いて実行する場合がありますが、こちらはスクリプトを実行して定義された変数や関数は実行後も残ります。

上記の例でいうと、この演算子が無いとPowerShellは「"$env:LOCALAPPDATA\\Programs\\Python\\Python310\\python.exe"」の部分をただの文字だと認識してしまい、エラーになります。
:::
い、エラーになります。
:::

:::tip
「$env:\[環境変数名\]」は、PowerShellで環境変数の値を使う場合に用いる書き方です。

「$env:」に続けて環境変数名を書くことで、コマンド実行時、その部分がその環境変数の値に変わって実行されます。

上記例のように「$env:LOCALAPPDATA」と書いた場合、その部分が「C:\\Users\\{ユーザー名}\\AppData\\Local」に変わって、以下のように実行されます。

環境変数を使うと、1つのコマンドで環境ごとの違いを吸収して実行できるようになります。
:::

[Windows 11の環境変数を画面操作で設定する方法【初心者向け】](/how-to-set-environment-variables-on-windows11/)

:::caution
実行時にエラーが発生する場合は、以下の記事を参考にトラブルシューティングしてみてください。

> [ターミナルで“コマンドが見つからない”エラーが出るときの対処方法【Windows】【初心者向け】](/how-to-fix-the-command-not-found-error-in-terminal/)

「py」や「python」の実行ファイルの場所は以下を参考にしてください。

-   py
    -   C:\\Windows\\py.exe
    -   C:\\Users\\{ユーザー名}\\AppData\\Local\\Programs\\Python\\Launcher\\py.exe
-   python
    -   C:\\Program Files\\Python{バージョン}\\python.exe
    -   C:\\Users{ユーザー名}\\AppData\\Local\\Programs\\Python\\Python{バージョン}\\python.exe
:::

[ターミナルで“コマンドが見つからない”エラーが出るときの対処方法【Windows】【初心者向け】](/how-to-fix-the-command-not-found-error-in-terminal/)

「py」や「python」の実行ファイルの場所は以下を参考にしてください。

- py
  - C:\\Windows\\py.exe
  - C:\\Users\\{ユーザー名}\\AppData\\Local\\Programs\\Python\\Launcher\\py.exe

- python
  - C:\\Program Files\\Python{バージョン}\\python.exe
  - C:\\Users{ユーザー名}\\AppData\\Local\\Programs\\Python\\Python{バージョン}\\python.exe

## venv仮想環境の使い方

![venv仮想環境の使い方のアイキャッチ画像](./ChatGPT-Image-2025年9月8日-16_33_08.jpg)

### venv仮想環境を有効にする方法

仮想環境フォルダを作成した際に自動生成される仮想環境有効化スクリプトを実行します。

コマンド）

#### 実行例

例）「D:\\test」フォルダに作成した「venv」仮想環境（Python 3.10）を有効化する

![「D:\test」フォルダに作成した「venv」仮想環境（Python 3.10）を有効化する（スクリプト）操作の画面キャプチャ](./image-29.png)

![「D:\test」フォルダに作成した「venv」仮想環境（Python 3.10）を有効化する（スクリプト実行後）操作の画面キャプチャ](./image-30.png)

![「D:\test」フォルダに作成した「venv」仮想環境（Python 3.10）を有効化する（スクリプト実行後、Pythonのバージョン確認）操作の画面キャプチャ](./image-31.png)

:::note
「(venv)」の表示が出ていれば、仮想環境が有効化されています。

この状態でpythonコマンドやスクリプトを実行すると、仮想環境内のPythonのバージョンでコマンドやスクリプトが実行されます。
:::

:::tip
仮想環境有効化スクリプト実行時にコマンドの先頭に書いてある「.（ドット）」は、「ドットソーシング演算子（Dot Sourcing operator）」と言います。

「Activate.ps1」は単なる「仮想環境を有効化する処理」を行うスクリプトですが、その中でやっていることは“環境変数の設定や関数の登録”です。

その設定を実行後も残したいので、「&」ではなく「.」を使っています。
:::

### venv仮想環境を無効にする方法

仮想環境が有効な状態で、仮想環境無効化コマンドを実行します。

コマンド）

#### 実行例

例）有効化した「D:\\test」フォルダに作成した「venv」仮想環境（Python 3.10）を無効化する

![有効化した「D:\test」フォルダに作成した「venv」仮想環境（Python 3.10）を無効化する（スクリプト実行後）操作の画面キャプチャ](./image-32.png)

![有効化した「D:\test」フォルダに作成した「venv」仮想環境（Python 3.10）を無効化する（スクリプト実行後、Pythonのバージョン確認）操作の画面キャプチャ](./image-33.png)

## おすすめの関連記事

[Pythonのダウンロード・インストール方法【Windows】【初心者向け】](/how-to-download-and-install-python-to-windows/)
[PyCharmのダウンロードとインストール方法【日本語化も】【Windows】【初心者向け】](/how-to-download-and-install-pycharm-ja-to-windows/)
[PyCharmでPythonのvenvを使うための設定方法【仮想環境】【Windows】【初心者向け】](/how-to-set-up-pycharm-to-use-python-venv-virtual-environment/)
[なぜPythonでvenvを使うのか？仮想環境の必要性を初心者向けに比較・解説](/why-use-venv-in-python/)
[ターミナルで“コマンドが見つからない”エラーが出るときの対処方法【Windows】【初心者向け】](/how-to-fix-the-command-not-found-error-in-terminal/)

## 参考

- [Python公式サイト（3.13.5 Documentation » Python 標準ライブラリ » ソフトウェア・パッケージと配布 » venv — 仮想環境の作成）](https://docs.python.org/ja/3.13/library/venv.html)