---
# System prepended metadata

title: "\U0001F4CC建立 Python 虛擬環境 (Virtual Environment)"
tags: [venv, "Python\_"]

---

# Mac / Windows 建立 Python 虛擬環境 (Virtual Environment)
我們可以使用 Python 內建的 venv 模組來建立虛擬環境，這樣就可以在不同的專案中使用獨立的 Python 套件，而不會影響系統環境。
##  1. 確保已安裝 Python

### 🔹 檢查 Python 是否已安裝：
##### 終端機:
`
python --version
`

🔹 若未安裝，請從[Python官方網站](https://www.python.org/downloads/)下載並安裝。
> 
> 📌 安裝時請勾選 Add Python to PATH，這樣可以在命令列直接使用 python

表示成功:
![image](https://hackmd.io/_uploads/HyjEnQvtye.png)

##  2. 創建 Python 虛擬環境

### 🔹 步驟 1：選擇專案目錄

##### 終端機:
`
cd C:\Users\YourUser\your_project
`
### 🔹 步驟 2：建立虛擬環境
##### 終端機:
`
python -m venv venv
`
## 3. 啟動虛擬環境(mac/windows)
### 🔹 Windows 命令提示字元 (cmd)
`
venv\Scripts\activate
`

當虛擬環境啟動後，命令列會顯示 (venv)：

![image](https://hackmd.io/_uploads/Hy-HpQvYye.png)
`當虛擬環境啟動後，所有 pip install 指令都只會影響該環境`
### 🔹 Mac 命令提示字元 (cmd)
`
source myenv/bin/activate
`



## 4. 安裝套件
這邊假設專案需求FastAPI，當可以pip自己想要的插件。
##### 終端機:
`
pip install fastapi uvicorn
`
#### 📌 檢查已安裝的套件

##### 終端機:
`
pip list
`
![image](https://hackmd.io/_uploads/HySMCQvY1e.png)

## 5. 停用虛擬環境
當你要離開虛擬環境時，只需輸入：
<mac/windows一樣指令>

`
deactivate
`

命令列的 (venv) 會消失，回到系統環境。

##  6. 刪除虛擬環境
如果不再需要這個虛擬環境，直接刪除 venv 目錄即可：

`
rm -r venv
`

## ✅ 總結
|**指令**|**說明**|
|-|-|
|python -m venv venv	|建立 Python 虛擬環境|
|venv\Scripts\activate	|啟動虛擬環境 (cmd)|
|venv\Scripts\Activate.ps1|啟動虛擬環境 (PowerShell)|
|source venv/Scripts/activate|啟動虛擬環境 (Git Bash)
|pip install fastapi|安裝套件|
|pip list	|查看已安裝套件|
|deactivate	|停用虛擬環境|
|rm -r venv	|刪除虛擬環境|

#### 這樣就可以在 Mac/Windows 上順利使用 Python 虛擬環境了！ 🚀