使用uv作为python管理工具有以下好处:
- 项目隔离:环境仅对当前项目生效,不同项目可使用不同 Python 版本和依赖。
- 零配置:无需手动指定环境路径,UV 自动管理关联关系。
- 跨平台一致:通过
uv.lock确保 Windows、Linux、macOS 环境完全一致。
安装uv
# -i代表指定镜像源,用于加快国内下载速度,例子中为清华镜像源
pip install uv -i https://pypi.tuna.tsinghua.edu.cn/simple
初始化项目
uv init demo
如果已有项目使用requirements.txt记录依赖可以用一下命令替换成pyproject.toml
uv init .
uv add -r requirements.txt
初始化虚拟环境
uv venv
锁定python版本
# 国内用户依然推荐使用镜像加速安装
uv python install 3.12 --pypy-mirror https://pypi.tuna.tsinghua.edu.cn/simple
uv python pin 3.12
安装依赖
uv add requests pandas # 安装生产依赖
uv add --dev pytest # 安装开发依赖(仅用于测试)
有的时候安装包的时候可能因为python环境和第三方库版本冲突导致安装失败,可以切换python版本和更换第三方库来解决
# 查看包有哪些版本
pip index versions 包名
根据uv配置安装包
uv sync
运行项目
使用该命令,uv会根据环境配置运行对应环境
uv run python main.py