python包管理工具uv的使用

416 阅读1分钟

使用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