UV快速搭建新项目

黄粱梦醒2026-05-06 9:54

python创建虚拟环境的方式有挺多，比如conda，venv以及最新的uv的方法。现在开始讲述uv搭建新项目的方法

1 install uv

linux 安装命令

arduino 复制代码

curl -LsSf https://astral.sh/uv/install.sh | sh

2 使用

bash 复制代码

# 1. 初始化项目（自动创建 pyproject.toml + .venv 虚拟环境）
uv init my_project [--python 3.12]
[]内是可选项，可以指定python 版本


# 2. 添加依赖（自动解析、下载、更新 uv.lock）
uv add fastapi uvicorn httpx pydantic


# 3. 运行代码（自动使用 .venv 中的 Python，无需手动激活）
uv run python -m uvicorn src.main:app --reload

# 4. 查看当前环境信息
uv python list
uv pip list  # 或使用 uv tree 查看依赖树
# 查看项目当前绑定的 Python
uv python list

# 后续修改项目绑定的 Python 版本（不重建 venv）
uv python pin 3.13

在上面的第2步中记得添加国内镜像源，可以写入初始化项目生成的pyproject.toml文件中。

ini 复制代码

[tool.uv]
index-url = "https://mirrors.aliyun.com/pypi/simple/"
extra-index-url = [
    "https://pypi.tuna.tsinghua.edu.cn/simple/",
    "https://pypi.org/simple/"
]