python项目和环境管理工具 UV

254 阅读2分钟

用UV创建项目

使用命令:

uv init <项目名称>

即可创建项目。

image.png

通过uv init创建的项目自带gitignore等相关配置文件。

image.png

其中python-versionpyproject.tomlUV用来管理虚拟环境的关键。python-version指定这个项目使用的python版本;而pyproject.toml是项目的说明书,包含了项目的名称、版本、依赖等内容,相当于setup.pyrequirements.txt

image.png

用UV管理环境

UV不需要手动激活虚拟环境环境,会自动使用对应的程序。UV会根据pyproject.toml来管理项目的依赖。

使用UV安装依赖

uv add <包的名称>

image.png 虚拟环境创建好了,包也安装了。

image.png pyproject.toml中的依赖也同步更新了。

并且通过uv add安装库比pip install速度更快。

使用UV运行程序

不需要激活虚拟环境,使用命令

uv run <文件名称>

image.png uv run自动匹配了相应的环境。

使用UV重现项目环境

根据pyproject.toml中的依赖,可以以下命令重现项目的虚拟环境:

uv sync

image.png 创建了新的符合项目依赖的虚拟环境。

用UV管理命令行工具

多个项目会用到某些命令行工具,例如pytest进行测试。对此可以进行全局安装,而不是安装到项目环境中:

uv tool install <命令行工具>

image.png

创建临时虚拟环境

对于某些临时运行的脚本,不需要为它们单独创建虚拟环境,只需要在使用UV创建项目的命令添加--script参数:

uv init --script <脚本名称>

image.png

脚本文件内容会多了一些元数据。UV会根据这些元数据创建临时的虚拟环境来安装依赖,来运行脚本。

image.png

参考

【uv】Python迄今最好的项目管理+环境管理工具