使用UV创建python项目

📅 2026/6/15 19:06:09
使用UV创建python项目
Python的UV工具介绍UVUltra-Violet是Python生态中一款新兴的轻量级包管理工具旨在替代pip和pip-tools提供更快的依赖解析与安装速度支持多平台和锁定文件机制。假设你的机器上只有Python 3.13执行uv init my-api --python 3.15uv 会创建项目目录生成pyproject.toml生成.python-version类似[project] name my-api requires-python 3.15.python-version 3.15此时通常还不会检查本机是否安装了 3.15。真正需要 Python 3.15 的时候是在后面执行uv sync或者uv run python这时 uv 会查找本地是否有 3.15没有的话自动下载 3.15创建.venv例如Downloading cpython-3.15.x Creating virtual environment... Installed packages...整个过程通常是自动完成的。一个完整例子假设全新机器系统只有 Python 3.13执行uv init my-api --python 3.15 cd my-api uv add fastapi[standard] uv sync当uv sync发现需要 Python 3.15 本机没有会自动下载cpython-3.15.x然后创建my-api/ ├── .venv ├── .python-version ├── pyproject.toml └── uv.lock此时uv run python --version输出Python 3.15.x唯一容易报错的情况如果你显式禁止下载uv sync --no-python-downloads或者配置了python-downloads never那么本机没有 3.15 时会报错No interpreter found for Python 3.15所以正常情况下uv init my-api --python 3.15即使电脑上没有 Python 3.15也不会有问题等到uv sync时uv 会自动帮你安装对应版本的 Python。