
為什麼不能直接「修改」虛擬環境?
在進行降級操作前,必須先釐清一個重要觀念:.venv 資料夾內的二進位檔案與庫(Library)是與特定的 Python 版本深度綁定的。如果你強行更換底層的 Python 執行檔,極大機率會導致路徑出錯或套件相依性崩潰。
核心操作步驟:從 3.14 退回 3.12
1. 備份現有的套件清單
在刪除環境前,請務必先記錄目前安裝了哪些套件,避免稍後遺忘。
- 在終端機執行:
pip freeze > requirements.txt
2. 徹底刪除舊的虛擬環境
直接將專案資料夾下的 .venv 目錄手動刪除,或使用指令:
- Windows (PowerShell):
Remove-Item -Recurse -Force .venv - macOS / Linux:
rm -rf .venv
3. 指定版本建立新環境
確保你電腦中已安裝 Python 3.12。接著使用特定指令建立環境:
- Windows:
py -3.12 -m venv .venv - macOS / Linux:
python3.12 -m venv .venv
4. 啟動新環境並還原套件
- 啟動環境:
- Windows: .venv\Scripts\activate
- macOS / Linux: source .venv/bin/activate
- 確認版本: 執行
python --version確保顯示為 3.12.X。 - 安裝套件: 執行
pip install -r requirements.txt
如何確認電腦中已安裝哪些 Python 版本?
如果你不確定電腦是否具備 3.12 版本,可以透過以下方式檢查:
Windows 系統
Windows 用戶最推薦使用 Python Launcher 指令:
- 列出所有版本:
py --list - 顯示安裝路徑:
py --list-paths
macOS 與 Linux 系統
- 自動補完法: 在終端機輸入
python後連續按兩下 Tab 鍵,系統會列出所有可用的 Python 指令(如 python3.10, python3.12)。 - Homebrew 查詢: 若使用 Brew 安裝,可輸入
brew list --versions | grep python。
使用版本管理工具
如果你有安裝版本管理工具,請使用專屬指令:
- pyenv:
pyenv versions - Conda:
conda env list
結語:更優雅的開發習慣
若你經常需要在不同版本間切換,建議安裝 pyenv (macOS/Linux) 或 pyenv-win (Windows)。透過版本管理工具,你可以輕鬆在不同專案間設定專屬的 Python 版本,而不需要每次都去搜尋 Python 安裝的路徑。






















