Mac 上使用 python 工具 uv

uv 是一個新的 Python 工具鏈，透過 效能優化、功能整合與使用者友善設計，簡化了 Python 專案的開發、依賴管理和發布流程。

MacOS 安裝 uv

最簡單的方式是使用 homebrew 安裝 uv

brew install uv

透過 uv 特定版本的 python

安裝好後可以查看已安裝的 python 版本

# 查看已安裝的 python 版本
uv python list

cpython-3.14.0a7-macos-aarch64-none                 <download available>
cpython-3.14.0a7+freethreaded-macos-aarch64-none    <download available>
cpython-3.13.3-macos-aarch64-none                   <download available>
cpython-3.13.3+freethreaded-macos-aarch64-none      <download available>
cpython-3.13.2-macos-aarch64-none                   /opt/homebrew/bin/python3.13 -> ../Cellar/python@3.13/3.13.2/bin/python3.13
cpython-3.13.2-macos-aarch64-none                   /opt/homebrew/bin/python3 -> ../Cellar/python@3.13/3.13.2/bin/python3
cpython-3.12.10-macos-aarch64-none                  <download available>
cpython-3.12.7-macos-aarch64-none                   /opt/homebrew/bin/python3.12 -> ../Cellar/python@3.12/3.12.7_1/bin/python3.12
cpython-3.11.12-macos-aarch64-none                  .local/share/uv/python/cpython-3.11.12-macos-aarch64-none/bin/python3.11
cpython-3.10.17-macos-aarch64-none                  <download available>
cpython-3.10.15-macos-aarch64-none                  /opt/homebrew/bin/python3.10 -> ../Cellar/python@3.10/3.10.15/bin/python3.10
cpython-3.9.22-macos-aarch64-none                   <download available>
cpython-3.9.6-macos-aarch64-none                    /usr/bin/python3

安裝特定版本的 python

uv python install 3.11

透過 uv 建立專案有兩種方式: - 和原有的 pip 和 venv 相容的方式 - 直接使用 uv 管理

搭配 pip 和 venv 建立專案

# 指定 python 版本，建立專案語法
uv venv --python=<version> <env-name>
# 範例
uv venv --python=3.12 .venv

這種方式的缺點是沒有記錄 python 版本，但實際上在 .venv/pyvenv.cfg 可以查看相關設定，但沒有記錄到版控。

# 安裝套件
uv pip install requests

直接使用 uv 管理

# 初始化專案
uv init --python 3.11

會直接建立專案的 git 設定，同時建立專案設定檔 pyproject.toml。

# 加入套件
uv add requests

加入任一套件後會自動建立 .venv 資料夾，並把虛擬環境建立起來。同時把安裝的套件記錄在 pyproject.toml。 pyproject.toml 的角色類似 nodejs 專案的 package.json。其他常用的指令如下：

# 查看 uv 用法
uv -h

# 移除套件
uv remove <套件>
uv remove requests

# 執行指令或程式
uv run <程式或指令>
uv run main.py

# 更新特定套件
uv lock --upgrade-package requests

# 更新所有套件
uv lock --upgrade