1.uv安装

[macOS 和 Linux]
curl -LsSf https://astral.sh/uv/install.sh | sh

[windows]
powershell -ExecutionPolicy ByPass -c "irm  | iex"

uv help 查看是否安装成功

2. python版本管理

#指定镜像源（不指定默认公共源）
$env:UV_PYTHON_INSTALL_MIRROR="xxx" 

#指定pypi源（不指定默认公共源）
$env:UV_INDEX_URL="https://xxx/pypi/pypi-gliese-virtual/simple"

#安装指定版本python
uv python install 3.13.2

# 查看已安装和可安装的Python版本
uv python list

3. 创建项目

uv init myproject
cd myproject

自动生成：

• pyproject.toml：项目元信息（名称、版本、Python 版本、依赖等）
• uv.lock：锁定所有依赖及其子依赖（禁止手动编辑）
• .gitignore、.python-version、hello.py（示例代码）

4. 同步依赖（uv sync）

uv sync

• 自动查找并安装合适的 Python 版本
• 创建虚拟环境 .venv
• 生成 uv.lock 文件，确保依赖一致性
• 一键完成环境搭建

注： uv pip sync 与 uv sync 的区别：

5. 运行项目

uv run hello.py

6. 管理依赖

• 添加依赖：

  uv add pandas
  

  自动递归安装所有依赖（如 numpy、pytz 等），速度极快。

• 删除依赖：

  uv remove pandas
  

  自动清理所有相关依赖，并更新 uv.lock。

7. 区分开发与生产依赖

uv add --group dev pandas      # 开发环境依赖
uv add --group production requests  # 生产环境依赖

• pyproject.toml 中会生成：

  [dependency-groups]
  dev = ["pandas>=2.2.3"]
  production = ["requests>=2.32.3"]
  

• 可分别同步：

  uv sync --group dev       # 只安装开发依赖
  uv sync --group production