跳轉到

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

使用 uv 建立虛擬環境

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

建議工作流程

uv inituv 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-versionmain.pyREADME.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 syncuv.lock 成為可重現的環境說明書。

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