uv-package-manager

概覽

什麼是 uv-package-manager？

uv-package-manager 是一款高效能的 Python 套件管理器與工作流程工具，專為大幅加速依賴安裝、虛擬環境管理及 Python 專案設定而設計。採用 Rust 編寫，uv 的速度比 pip 快 10 到 100 倍，並提供現代 Python 後端開發所需的進階功能。

誰適合使用 uv-package-manager？

• 追求更快依賴管理的 Python 後端開發者
• 管理 monorepo 或複雜依賴樹的團隊
• 希望縮短建置時間的 CI/CD 管理者
• 從 pip、pip-tools 或 poetry 遷移的開發者
• 優化基於 Docker 的 Python 工作流程的使用者

解決的問題

• pip 安裝依賴速度緩慢
• 複雜的虛擬環境與 Python 版本管理
• 建置與部署的可重現性問題
• 低效率的 CI/CD 與 Docker 建置流程

使用說明

安裝步驟

1. 將此技能加入您的代理設定：

   npx skills add https://github.com/wshobson/agents --skill uv-package-manager

2. 瀏覽核心文件：

   • 從 SKILL.md 開始，獲得完整概覽。
   • 查看 references/advanced-patterns.md，了解進階工作流程，包括 CI/CD 與 Docker 整合。

基本使用範例

• 安裝依賴：

  uv pip install -r requirements.txt

  或使用鎖定檔：

  uv sync

• 建立與管理虛擬環境：

  uv venv create

• 安裝特定 Python 版本：

  uv python install 3.12

• 整合 CI/CD：
  使用 astral-sh/setup-uv GitHub Action 以加速工作流程中的安裝。

進階工作流程

• Monorepo 支援：
  在根目錄的 pyproject.toml 定義工作區成員，並使用 uv sync 同步所有套件。
• Docker 優化：
  使用官方 uv 容器映像或將 uv 執行檔複製到 Dockerfile 中，以實現高效依賴快取與可重現建置。

重要檔案結構

• SKILL.md：主要指南與使用範例
• references/advanced-patterns.md：進階整合與故障排除

常見問題

uv-package-manager 是 pip 的直接替代品嗎？

是的，uv 相容大多數 pip 工作流程，可作為更快速安裝與更佳依賴解析的直接替代方案。

什麼時候應該使用 uv-package-manager 而非 pip 或 poetry？

當您需要更快的安裝速度、進階鎖定檔支援、可重現建置，或高效的 monorepo 與 CI/CD 工作流程時，建議使用 uv。

如何將 uv-package-manager 整合到 Docker 或 CI/CD？

請參考 references/advanced-patterns.md 中的範例，內含可直接使用的 Dockerfile 與 GitHub Actions 範本。

哪裡可以找到更多使用範例與故障排除技巧？

請查看技能目錄中的 SKILL.md 與 references/advanced-patterns.md，內含詳細指南、遷移建議及最佳實踐。

uv-package-manager 支援哪些平台？

uv 支援 Linux、macOS 與 Windows，適用於大多數後端開發與部署環境。