python项目和依赖管理工具uv简介

uv是一个python管理工具的集大成者,一个工具将项目管理、虚拟环境管理、开发工具使用和管理等等集于一身。

这里只是入门简介,更详细的使用方法请参考官方文档。

文章目录

项目管理

创建项目

开发的第一步就是创建项目。项目一般由:源代码、编译和构建工具、环境配置、IDE配置、Git配置、流水线配置等等组成。

bash 复制代码
# 文件夹名称会默认作为项目名称
uv init <dictionary>


python-version 用来指定项目用到的python版本;pyproject.toml用来描述整个项目,包括依赖、项目名称等。这两个文件是项目运行和虚拟环境管理的关键配置文件。

单文件项目

除了上面这种情况,uv允许将所有项目信息写入py文件中,实现一个文件就是一个项目。

bash 复制代码
uv init --script <py-file>
# 例如
uv init --script main.py

此时无需创建复杂项目结构也能实现复杂功能。非常适合脚本场景。

协同

当从仓库下载代码或者修改项目配置(如修改.python-version版本号),需要运行uv sync这个命令会自动按照配置文件配置本地环境(python版本、依赖包等)。如果本地没有匹配的python版本,则会自动下载对应版本。

环境管理

添加依赖

使用uv管理依赖时不需要提前激活虚拟环境(如:conda),也不需要不定期的保存requirements.txt文件。仅仅需要一行命令uv add <package-name>就可以了(如:uv add requests)。这个命令会一次性创建虚拟环境、安装依赖、更新项目文件。

运行

使用uv run <py-file>可以直接运行python脚本。他会自动启动对应虚拟环境,使用环境中的依赖。

命令行工具

开发时会用到一些python编写的工具,如:pytest。使用uv时可以直接使用uv tool install pytest进行安装。然后就可以直接在命令行使用pytest

如果不想安装工具,直接使用,那么可以使用uvx命令。uvx pytest可以直接运行pytest工具,并且不会安装到项目中

命令行简介

uv python 负责python相关命令,如安装指定版本python。

uv venv 用于管理和配置虚拟环境。如设置虚拟环境使用的python版本。

配置文件

镜像源

通过修改pyproject.toml指定默认镜像源

toml 复制代码
[[tool.uv.index]]
url = "https://test.pypi.org/simple"
default = true

如果要全局配置,则需要修改~/.config/uv/uv.toml或者/etc/uv/uv.toml

toml 复制代码
[[index]]
url = "https://test.pypi.org/simple"
default = true

下面代码演示了如何针对每个包单独设置镜像源

toml 复制代码
[project]
dependencies = ["torch"]

[tool.uv.sources]
torch = [
  { index = "pytorch-cu118", marker = "sys_platform == 'darwin'"},
  { index = "pytorch-cu124", marker = "sys_platform != 'darwin'"},
]

[[tool.uv.index]]
name = "pytorch-cu118"
url = "https://download.pytorch.org/whl/cu118"

[[tool.uv.index]]
name = "pytorch-cu124"
url = "https://download.pytorch.org/whl/cu124"
相关推荐
caimo几秒前
Java无法访问网址出现Timeout但是浏览器和Postman可以
java·开发语言·postman
三体世界28 分钟前
Qt从入门到放弃学习之路(1)
开发语言·c++·git·qt·学习·前端框架·编辑器
悟能不能悟35 分钟前
jdk25结构化并发和虚拟线程如何配合使用?有什么最佳实践?
java·开发语言
柠檬071144 分钟前
MATLAB相机标定入门:Camera Calibration工具包详解
开发语言·数码相机·matlab
卓码软件测评1 小时前
借助大语言模型实现高效测试迁移:Airbnb的大规模实践
开发语言·前端·javascript·人工智能·语言模型·自然语言处理
熙客1 小时前
Java8:Lambda表达式
java·开发语言
小咕聊编程1 小时前
【含文档+PPT+源码】基于java web的篮球馆管理系统系统的设计与实现
java·开发语言
我狸才不是赔钱货2 小时前
Python的“环境之殇”:从Venv到Conda的终极抉择
开发语言·python·conda
努力进修2 小时前
Rust 语言入门基础教程:从环境搭建到 Cargo 工具链
开发语言·后端·rust
程序员爱钓鱼3 小时前
Python编程实战 - 函数与模块化编程 - 参数与返回值
后端·python·ipython