使用 uv 建立虛擬環境
uv 不只裝套件,也能建立虛擬環境、安裝指定的 Python 版本,並用 uv run 在正確環境裡執行程式。套件安裝細節請看 使用 uv 安裝套件。
建議工作流程
uv init → uv add 套件 → uv run python 檔名.py
多數情況不必手動 activate。
安裝/切換 Python 版本
uv 可以幫你安裝 Python,不必先裝 Anaconda 或自己下載安裝檔。
指定專案使用的版本(會寫入 .python-version):
建立虛擬環境
預設會在目前目錄建立 .venv:
指定名稱或 Python 版本:
啟動方式與一般 venv 相同:
離開環境:
其實常常不用啟動
用 uv run 執行時,uv 會自動使用專案的 .venv。這是最不容易搞混的用法。
建議:用專案模式管理環境
初始化專案
會產生 pyproject.toml、.python-version、main.py、README.md 等檔案。
加入套件並自動建立環境
uv 會建立 .venv、更新 pyproject.toml,並寫入 uv.lock。
執行程式
uv run 會先確認環境與鎖定檔一致,再執行指令。
同步環境
把別人的專案 clone 下來後,在專案目錄執行:
會依 uv.lock(或 pyproject.toml)建立/更新 .venv,團隊成員會拿到同一組套件版本。
只更新鎖定檔、不安裝:
單支腳本也能管依賴
不必先建立專案,也可以幫單一 .py 宣告依賴:
適合小練習、隨手寫的工具腳本。
跟其他工具怎麼選?
| 工具 | 建立環境 | 管理 Python 版本 | 適合誰 |
|---|---|---|---|
| uv | 自動(.venv) |
可以 | 新專案首選 |
| venv | 手動 | 否 | 只要官方內建工具 |
| conda | 內建 | 可以 | 資料科學、非 Python 依賴 |
| pipenv | 自動 | 否 | 已在用 Pipfile 的專案 |
總結
uv venv可快速建立虛擬環境;日常更建議uv init+uv add。uv run會自動使用正確環境,減少「裝到系統 Python」的問題。uv sync讓uv.lock成為可重現的環境說明書。
套件指令請回到 使用 uv 安裝套件。