如何安裝並使用 uv：建立 Python 專案、加入套件並執行腳本

依官方步驟安裝 uv，初始化專案、加入一個套件，並用 uv run 執行腳本。

要在本機用 uv 管理 Python 專案，先完成四件事：依官方方式安裝，uv init 建立專案，uv add 加入一個套件，再用 uv run 執行腳本。

依 docs.astral.sh/uv/ 走，不要猜套件名。核心檢索詞是 如何安裝 uv、uv init，以及 uv run 執行腳本。安裝入口在 astral.sh/uv。

先依系統裝官方二進位

安裝、建專案、加套件、跑腳本

1. 01
   安裝並確認版本

   依 docs.astral.sh/uv/getting-started/installation/ 選腳本或 Homebrew。裝完 uv --version 應印出版本。找不到指令就重開終端機，檢查 PATH。

2. 02
   建立專案

   在目標父目錄執行 uv init myproject，再 cd myproject。應看到 pyproject.toml。已有空目錄可用 uv init 就地初始化。

3. 03
   加入一個套件

   執行 uv add httpx（示例）。uv 會解析依賴、寫鎖定檔並準備環境。失敗時核對套件名與網路，不要手改半截鎖定檔。

4. 04
   寫腳本並執行

   新建 hello.py，用剛加的套件寫幾行可執行程式，然後 uv run python hello.py。需要固定直譯器時先 uv python install。

curl -LsSf https://astral.sh/uv/install.sh | sh
uv --version
uv init myproject
cd myproject
uv add httpx
# 寫好 hello.py 後：
uv run python hello.py

必須用官方安裝腳本嗎？

不必。文件還列出 Homebrew、WinGet 等管道。選一種，裝完用 uv --version 驗證即可。不要混裝多個互搶 PATH 的副本。

還要自己建 venv 嗎？

日常不必。uv add 與 uv run 會使用專案虛擬環境。把 .venv 加入 .gitignore，不要提交環境目錄。

uv run 和直接 python 有何不同？

直接呼叫系統 python 可能看不到專案依賴。uv run 會依專案設定選用直譯器與已安裝的套件。

裝完就能當白板用嗎？

不能。這是 Python 工具鏈。要對著同一張圖說話時，再開 sitdraw。