uv 会自动创建并管理 Python 环境，这是它相比传统 pip + venv 工作流的核心优势之一。它管理两个层面的环境：
┌─────────────────────────────────────────────┐ │ uv 自动环境创建流程 │ └─────────────────────────────────────────────┘ │ ▼ 检查项目根目录下是否存在 .venv/ │ ┌────┴────┐ │ │ 存在 不存在 │ │ │ ▼ │ ① 读取 pyproject.toml 的 requires-python │ ② 查找/下载符合版本约束的 Python 解释器 │ ③ 在项目根目录创建 .venv/ │ ④ 用该解释器初始化虚拟环境 │ │ └────┬────┘ ▼ 将依赖按 uv.lock 安装到 .venv/安装
curl -LsSf https://astral.sh/uv/install.sh | sh 安装完成后，重新加载 shell 环境变量： source $HOME/.local/bin/env到项目下安装环境
# 2. 切到项目目录再 sync（uv sync 需要在含 pyproject.toml 的目录执行） cd project/ uv sync┌─────────────────────────────────────────────────────────────┐ │ uv sync 执行流程 │ └─────────────────────────────────────────────────────────────┘ │ ▼ ① 定位项目根目录（向上查找 pyproject.toml） │ ▼ ② 读取 pyproject.toml ──── 获取依赖声明、Python 版本要求 │ ▼ ③ 读取/生成 uv.lock ──── 锁定每个包的精确版本与哈希 │ （不存在则自动 uv lock 生成） ▼ ④ 创建/复用 .venv ──── 默认在项目根目录 │ ▼ ⑤ 解析依赖差异 ──── 对比 venv 现状 vs lock 声明 │ ▼ ⑥ 安装/卸载/升级包 ──── 让 venv 与 lock 完全一致 │ （默认会移除 lock 之外的额外包） ▼ ⑦ 安装项目自身（editable）使用
# ① 进项目 cd project/ # ② 同步依赖（首次或 pull 之后） uv sync # ③ 日常使用 —— 全部用 uv run，不激活 uv run python examples/pyspark/pyspark_quickstart.py uv run pytest uv run python # 想要 REPL 时
