Python 的 `venv` 模組是用來建立和管理虛擬環境的工具，能為每個專案創建隔離的 Python 環境，避免套件衝突。以下是使用方式、注意事項和限制的詳細說明：
---
### **一、如何使用 `venv`**
1. **創建虛擬環境**
使用 `python -m venv <環境名稱>` 命令來創建虛擬環境。例如：
```bash
python -m venv myenv
```
- 這會在當前目錄下創建一個名為 `myenv` 的資料夾，包含獨立的 Python 執行檔和 `pip`。
- 通常將虛擬環境放在專案目錄內，例如 `./venv` 或 `./env`。
2. **啟動虛擬環境**
啟動後，命令列會切換到該虛擬環境，使用的 Python 和 `pip` 會是環境內的版本。根據作業系統，命令如下：
- **Windows**:
```bash
myenv\Scripts\activate
```
- **macOS/Linux**:
```bash
source myenv/bin/activate
```
- 啟動後，命令列提示符會顯示 `(myenv)`，表示已進入虛擬環境。
3. **安裝套件**
在虛擬環境中，使用 `pip` 安裝套件，這些套件僅安裝在當前環境中，不影響系統全局。例如：
```bash
pip install requests
```
- 可以用 `pip list` 查看已安裝的套件。
- 建議使用 `requirements.txt` 記錄依賴：
```bash
pip freeze > requirements.txt
```
其他環境可透過 `pip install -r requirements.txt` 還原套件。
4. **退出虛擬環境**
輸入以下命令退出虛擬環境：
```bash
deactivate
```
5. **刪除虛擬環境**
直接刪除虛擬環境資料夾即可，例如：
```bash
rm -rf myenv # Linux/macOS
rmdir /s myenv # Windows
```
---
### **二、注意事項**
1. **選擇正確的 Python 版本**
- 創建虛擬環境時，使用的 Python 版本取決於執行 `python -m venv` 的 Python 版本。確保使用正確的 Python（例如 `python3` 或特定版本如 `python3.8`）。
- 可透過 `python --version` 確認當前使用的 Python 版本。
2. **虛擬環境是獨立的**
- 虛擬環境不包含系統全局的套件，除非明確安裝。例如，系統已安裝 `numpy`，但虛擬環境中需要重新安裝。
- 若需要使用系統套件，可在創建時加上 `--system-site-packages`：
```bash
python -m venv myenv --system-site-packages
```
3. **跨平台注意**
- 虛擬環境與作業系統和 Python 版本綁定，不能直接在不同作業系統間共用。例如，Windows 創建的環境無法在 Linux 上使用。
- 若需跨平台，建議分享 `requirements.txt`，在目標系統重新創建環境。
4. **環境路徑管理**
- 虛擬環境的路徑不宜過長，特別在 Windows 上，因其有檔案路徑長度限制（約 260 字元）。
- 避免將虛擬環境放在會被頻繁移動的目錄（如雲端同步資料夾），可能導致路徑損壞。
5. **升級 `pip`**
- 虛擬環境中的 `pip` 可能不是最新版本，建議啟動環境後立即升級：
```bash
pip install --upgrade pip
```
6. **版本控制**
- 不要將虛擬環境資料夾（例如 `venv/`）加入 Git 等版本控制系統，通常只提交 `requirements.txt`。
- 在 `.gitignore` 中加入 `venv/` 或 `env/`。
---
### **三、限制**
1. **不支援多版本 Python 切換**
- `venv` 僅使用創建時的 Python 版本。若需在同一環境中使用不同版本的 Python，需使用其他工具如 `pyenv` 或 `conda`。
2. **不支援全局套件管理**
- `venv` 無法直接管理系統級的 Python 套件，若需全局管理，需使用系統的 `pip` 或其他工具。
3. **不支援環境複製**
- 無法直接複製虛擬環境到其他目錄或機器，需重新創建並安裝依賴。
4. **依賴解析較弱**
- `venv` 的 `pip` 不像 `poetry` 或 `pipenv` 那樣有強大的依賴解析功能，可能在複雜專案中遇到版本衝突問題。
5. **資源占用**
- 每個虛擬環境都包含獨立的 Python 執行檔和標準庫，會占用一定磁碟空間（通常幾十 MB）。
---
### **四、進階使用**
1. **環境變數管理**
- 可以在虛擬環境的啟動腳本（如 `myenv/bin/activate` 或 `myenv\Scripts\activate.bat`）中加入環境變數，方便專案配置。
- 例如，設定 `PYTHONPATH` 或自訂變數。
2. **與 IDE 整合**
- 大多數 IDE（如 VSCode、PyCharm）能自動偵測 `venv` 環境，選擇虛擬環境作為解釋器即可。
3. **使用 `venv` 進行測試**
- 可為不同測試場景創建多個虛擬環境，模擬不同套件版本或依賴。
4. **搭配其他工具**
- 若需更強大的環境管理，可結合 `pyenv`（管理 Python 版本）或 `poetry`（管理依賴和打包）。
---
### **五、常見問題**
- **Q: 為什麼啟動虛擬環境後仍使用全局 Python？**
A: 可能是路徑配置錯誤，檢查環境變數 `PATH` 是否優先指向虛擬環境的 `bin` 或 `Scripts` 目錄。
- **Q: 如何在 Jupyter Notebook 使用虛擬環境？**
A: 安裝 `ipykernel` 並註冊虛擬環境：
```bash
pip install ipykernel
python -m ipykernel install --user --name=myenv
```
- **Q: 如何在 CI/CD 中使用 `venv`？**
A: 在 CI/CD 腳本中，創建虛擬環境並用 `requirements.txt` 安裝依賴，確保一致性。
---
### **總結**
`venv` 是 Python 官方提供的輕量級虛擬環境工具，適合大多數專案需求。使用簡單，但功能相對基礎，適合需要隔離環境但不要求複雜依賴管理的場景。若需更進階的功能，可考慮 `conda`、`poetry` 或 `pipenv`。遵循上述注意事項，能有效避免常見問題並提高開發效率。
沒有留言:
張貼留言