跳轉到

建立 2026-09-11 更新 2026-09-12

使用 uv 建立虛擬環境

uv 不只裝套件,也能建立虛擬環境、安裝指定的 Python 版本,並用 uv run 在正確環境裡執行程式。套件安裝細節請看 使用 uv 安裝套件。

建議工作流程

uv init → uv add 套件 → uv run python 檔名.py
多數情況不必手動 activate。

安裝/切換 Python 版本

uv 可以幫你安裝 Python,不必先裝 Anaconda 或自己下載安裝檔。

uv python install 3.12
uv python list

指定專案使用的版本(會寫入 .python-version):

uv python pin 3.12

建立虛擬環境

預設會在目前目錄建立 .venv:

uv venv

指定名稱或 Python 版本:

uv venv myenv
uv venv --python 3.12

啟動方式與一般 venv 相同:

.venv\Scripts\activate
source .venv/bin/activate

離開環境:

deactivate

其實常常不用啟動

用 uv run 執行時,uv 會自動使用專案的 .venv。這是最不容易搞混的用法。

建議:用專案模式管理環境

初始化專案

uv init myproject
cd myproject

會產生 pyproject.toml、.python-version、main.py、README.md 等檔案。

加入套件並自動建立環境

uv add requests

uv 會建立 .venv、更新 pyproject.toml,並寫入 uv.lock。

執行程式

uv run python main.py

uv run 會先確認環境與鎖定檔一致,再執行指令。

同步環境

把別人的專案 clone 下來後,在專案目錄執行:

uv sync

會依 uv.lock(或 pyproject.toml)建立/更新 .venv,團隊成員會拿到同一組套件版本。

只更新鎖定檔、不安裝:

uv lock

單支腳本也能管依賴

不必先建立專案,也可以幫單一 .py 宣告依賴:

uv add --script example.py requests
uv run example.py

適合小練習、隨手寫的工具腳本。

跟其他工具怎麼選?

工具 建立環境 管理 Python 版本 適合誰
uv 自動(.venv) 可以 新專案首選
venv 手動 否 只要官方內建工具
conda 內建 可以 資料科學、非 Python 依賴
pipenv 自動 否 已在用 Pipfile 的專案

總結

  • uv venv 可快速建立虛擬環境;日常更建議 uv init + uv add。
  • uv run 會自動使用正確環境,減少「裝到系統 Python」的問題。
  • uv sync 讓 uv.lock 成為可重現的環境說明書。

套件指令請回到 使用 uv 安裝套件。