---

Step 1 安裝 uv

macOS / Linux

curl -Ls https://astral.sh/uv/install.sh | sh

或使用 Homebrew：

brew install uv

Windows (PowerShell)

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

確認安裝成功：

uv --version

---

Step 2 建立專案資料夾

mkdir my-python-project
cd my-python-project

---

Step 3 建立虛擬環境

uv my-python-project-venv

會產生：

.my-python-project-venv/

---

Step 4 啟動虛擬環境

macOS / Linux

source .my-python-project-venv/bin/activate

Windows

.my-python-project-venv\Scripts\activate

看到 (my-python-project-venv) 代表成功啟動虛擬環境環。

---

Step 5 安裝套件

例如安裝 FastAPI：

uv pip install fastapi

你也可以：

uv add fastapi

差異：

• uv pip install → 類似傳統 pip
• uv add → 會更新依賴檔（推薦）

---

Step 6 鎖定依賴

uv lock

會產生 lock 檔案，確保團隊環境一致。

---

建議的專案初始化完整流程

uv init
uv add fastapi
uv add uvicorn
uv run main.py

---

什麼時候適合用 uv？

• 新專案
• API 服務
• Docker 專案
• 需要高效 CI/CD

那我到底該選 venv & uv 哪個？

我會這樣分：

• 新專案 → 用 uv
• 公司或舊專案 → 用 venv
• 團隊需要標準化 → uv 比較舒服

---

最後想跟你說

真正重要的不是 uv 還是 venv。

而是你有沒有養成這個習慣：

每一個專案，都給它一個獨立環境。

這是工程師成長的分水嶺。

當你開始這樣做，你會發現：

你不是只有在「寫程式」。

你是正在開始學會管理「系統」。