使用 uv 安裝套件
uv 是 Astral 推出的 Python 套件與專案管理工具，速度比 pip 快很多，也能一併管理虛擬環境與 Python 版本。初學者可以把 uv 想成「更快、更好用的 pip + venv」。
先記住這兩句
臨時裝套件：uv pip install 套件名稱
專案依賴：uv add 套件名稱
虛擬環境與 uv run、uv sync 請看 使用 uv 建立虛擬環境。
安裝 uv
官方建議用獨立安裝程式，不需要先有 Python。
安裝完成後重新開啟終端機，確認版本：
之後若用獨立安裝程式安裝，可用 uv self update 更新。
用 uv pip 安裝套件
uv pip 的指令幾乎跟 pip 一樣，適合你已經習慣 pip install 的情況。
安裝套件
一次安裝多個套件：
更新套件
移除套件
列出已安裝套件
list 與 freeze
uv pip freeze 的輸出格式可存成 requirements.txt，方便之後還原環境。
從 requirements.txt 安裝
若只要讓環境「剛好」等於檔案內容（多的會移除），可用：
用 uv add 管理專案依賴
若專案裡有 pyproject.toml（可用 uv init 建立），建議改用 uv add。它會：
- 自動建立
.venv虛擬環境 - 把套件寫進
pyproject.toml - 產生
uv.lock鎖定版本 - 立刻安裝套件
開發時才需要的工具（例如測試套件）可加 --dev：
移除依賴：
執行程式時不必先 activate，直接：
跟 pip 差在哪？
| 特點 | pip | uv |
|---|---|---|
| 速度 | 一般 | 通常快 10～100 倍 |
| 指令習慣 | pip install |
uv pip install 或 uv add |
| 虛擬環境 | 需另外用 venv |
內建，uv add / uv run 會自動處理 |
| 鎖定版本 | requirements.txt |
uv.lock（也可搭配 requirements） |
| Python 版本 | 不管理 | 可用 uv python install |
怎麼選？
新專案優先用 uv add + uv run。
舊專案已經有 requirements.txt，先用 uv pip install -r requirements.txt 就好。
總結
- 安裝 uv 後，
uv pip install 套件幾乎可直接取代pip install 套件。 - 專案開發請用
uv add，依賴會寫進pyproject.toml與uv.lock。 - 執行程式用
uv run，環境會自動對齊，比較不容易裝錯地方。
下一步：使用 uv 建立虛擬環境。