uv

为什么推荐 uv？ 因为它不仅管理包，还能管理 Python 版本（类似 nvm + npm 合体）。你甚至不需要预先安装 Python，它会自动下载。

安装 (Mac/Linux)

# (Mac/Linux)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

初始化项目

mkdir my-project && cd my-project
uv init  # 生成 pyproject.toml 和 .python-version

安装依赖

不用手动安装 Python，直接添加依赖

# uv 会自动下载合适的 Python 版本并创建虚拟环境
uv add fastapi uvicorn

运行代码

# 自动识别虚拟环境运行，不用手动 activate
uv run main.py

同步环境

拿到别人的 pyproject.toml 和 uv.lock

uv sync  # 安装 pyproject.toml 中指定的所有依赖

uv sync 会自动创建虚拟环境（如果不存在），并根据 uv.lock 极速安装所有依赖。这是目前 Python 生态中最快的方式。

拓展

神技：运行脚本 (类似 npx): 假设你有一个独立的脚本 script.py，里面用到了 requests 库，但你不想创建一个完整的项目环境。

# script.py
import requests
print(requests.get("https://httpbin.org/json").json())

直接运行：

uv run script.py