项目级 python 包管理工具 UV

索西引擎2026-04-13 8:16

Anaconda 虽然方便，但其全局安装机制会导致项目见以来冲突的问题。Python 默认的依赖安装（pip 是 Python 的「包管理工具」，安装 Python 3.4 及以上版本时，pip 会自动一起装上，不需要额外下载）方式类似于前端 NPM 的-g 全局安装，不适用于多项目开发。我们打开 python 的目录就可以看到，。因此引入 UV 作为 Python 项目级别的包管理工具，类似前端的 NPM，解决依赖隔离问题。

接下来安装 UV。

官网提供了几种方式，安装成功后，我们库会放在

接下来我们可以通过 uv 去创建并初始化一个项目，常见的命令如下

使用 uv init 创建并初始化一个项目

初始化后的项目有三个文件，分别是 README.md、main.py、pyproject.toml。pyproject.toml 类似前端的 package.json 。

尝试使用 uv add 安装 pyyaml 依赖，这个时候 pyyaml 这个库就被安装在当前这个项目目录下安装，而不是安装在全局。同时 uv 会在当前这个项目中创建一个 .venv 文件，这个文件主要用来管理当前项目 python 的环境。依赖被安装在项目内部的 .venv 目录下，实现不同项目的版本隔离。

uv配置阿里云源

支持修改镜像源以提升依赖下载速度，如配置阿里云镜像源。在 pyproject.toml 中添加：

python 复制代码

[[tool.uv.index]]
url = "https://mirrors.aliyun.com/pypi/simple/"
default = true

相比传统 pip 全局安装方式，UV 可以避免因依赖升级导致旧项目不可用的问题。