UV Python 项目环境配置指南

install_python/├── demo_project/          # Python 3.9 项目│   ├── .python-version    # 指定Python 3.9│   ├── pyproject.toml     # 项目配置和依赖│   ├── .venv/            # 虚拟环境│   └── main.py           # 数据处理脚本└── python_312_proj/      # Python 3.12 项目    ├── .python-version    # 指定Python 3.12    ├── pyproject.toml     # 项目配置和依赖    ├── .venv/            # 虚拟环境    └── main.py           # FastAPI Web应用

# 创建Python 3.9项目mkdir my_project_39cd my_project_39uv init --python 3.9
# 创建Python 3.12项目mkdir my_project_312cd my_project_312uv init --python 3.12

# 进入项目目录cd existing_project
# 指定Python版本echo "3.9" > .python-version
# 初始化项目配置uv init
# 添加依赖uv add requests pandas numpy

# 无需激活虚拟环境，直接运行uv run python script.py
# 运行特定Python版本uv run --python 3.12 python script.py
# 安装并运行uv run --with requests python -c "import requests; print('Hello')"

# 添加生产依赖uv add requests pandas
# 添加开发依赖uv add --dev pytest black
# 添加指定版本uv add "requests>=2.25.0"
# 添加可选依赖uv add --optional redis

# 移除依赖uv remove requests
# 移除开发依赖uv remove --dev pytest

# 同步到最新版本uv sync
# 同步到锁文件版本uv sync --frozen

# 进入项目目录，自动使用指定Python版本cd demo_projectuv run python --version  # Python 3.9.23
cd ../python_312_projuv run python --version  # Python 3.12.11

# 激活虚拟环境source .venv/bin/activate
# 或使用uv run（推荐）uv run python script.py
# 查看已安装包uv pip list

uv init [--python VERSION] [--name PROJECT_NAME]

uv add PACKAGE [VERSION]     # 添加依赖uv remove PACKAGE           # 移除依赖uv sync                     # 同步环境uv lock                     # 更新锁文件

uv run COMMAND              # 在项目环境中运行命令uv run --python VERSION     # 指定Python版本运行uv run --with PACKAGE       # 临时安装包并运行

uv tool install black       # 安装工具uv tool run black .         # 运行工具

[project]name = "my-project"version = "0.1.0"description = "项目描述"requires-python = ">=3.9"dependencies = [    "requests>=2.25.0",    "pandas>=1.3.0",]
[project.optional-dependencies]dev = [    "pytest>=6.0",    "black>=21.0",]test = [    "pytest-cov>=2.0",]

3.9