python依赖管理工具UV的安装和使用教程

更新时间：2025年09月25日 11:16:11 作者：qq_38608184

UV是一个用Rust编写的Python包安装和依赖管理工具,比传统工具（如 pip）有着更快、更高效的体验,这篇文章主要介绍了python依赖管理工具UV的安装和使用的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下

前言

注：dify的插件是依赖uv的，对于dify1.0.0以及后续的版本，需要安装uv。

一、命令安装uv

官网安装步骤（https://docs.astral.sh/uv/getting-started/installation/）。运行以下其中一个命令安装uv，安装会受网速影响。

curl -LsSf https://astral.sh/uv/install.sh | sh

wget -qO- https://astral.sh/uv/install.sh | sh

curl -LsSf https://astral.sh/uv/0.7.12/install.sh | sh  # 安装指定版本的uv

以下是独立安装拆分步骤

# 1. 先下载脚本并检查
curl -LO https://astral.sh/uv/0.7.12/install.sh
# 2. 检查脚本内容
cat install.sh      # 或使用文本编辑器查看
# 3. 确认安全后执行
sh install.sh

二、手动编译安装

2.1在archlinux安装uv的依赖工具

sudo pacman -Syu base-devel git python python-pip rust

base-devel：提供 gcc、make 等编译工具。
git：用于克隆源码。
python 和 python-pip：uv 是 Python 工具，需要 Python 环境。
rust：uv 是用 Rust 编写的，需要 Rust 工具链。

2.2从Github网站获取源码

uv项目的Github网址https://github.com/astral-sh/uv/tree/0.7.12。直接下载zip源码，然后解压复制到archlinux中/root目录下。或者运行以下命令下载：

git clone https://github.com/astral-sh/uv.git
cd uv

git checkout tags/0.7.12  # 该步可选，切换到指定版本（如 0.7.12）

2.3 编译安装

更换 Cargo 镜像源（推荐）

编辑 Cargo 配置文件 ~/.cargo/config.toml，添加国内镜像源（如清华源或中科大源）：

[source.crates-io]
replace-with = 'tuna'  # 或 'ustc'

# 清华大学镜像源
[source.tuna]
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"

# 或中科大镜像源
[source.ustc]
registry = "https://mirrors.ustc.edu.cn/crates.io-index/"

生效方式：

保存文件后，重新运行 cargo build --release。

调整超时设置（临时缓解）

在 ~/.cargo/config.toml 中增加超时时间（不推荐长期使用）：

[net]
git-fetch-with-cli = true  # 使用系统 git 代替内置 git
timeout = 120              # 超时时间设为 120 秒

使用 cargo 构建

cargo build --release

编译完成后,安装到指定目录

mkdir -p ~/.local/bin
cp target/release/uv ~/.local/bin/

cp target/release/uv /root/uv/uv-0.7.12

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.profile
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bash_profile

exec "$SHELL"   # 重启shell，使设置的环境变量生效

2.4 验证安装

uv --version

应输出类似：

uv 0.7.12

2.5删除target

如果已经确认uv编译完成，可以删除target文件夹来释放存储空间

进入uv所在目录，查看uv依赖项
ldd ./uv

rm -r /root/uv/uv-0.7.12/target
尽量保留.so文件

2.6使用示例

$ uv init example
Initialized project `example` at `/home/user/example`

$ cd example

$ uv add ruff
Creating virtual environment at: .venv
Resolved 2 packages in 170ms
   Built example @ file:///home/user/example
Prepared 2 packages in 627ms
Installed 2 packages in 1ms
 + example==0.1.0 (from file:///home/user/example)
 + ruff==0.5.0

$ uv run ruff check
All checks passed!

$ uv lock
Resolved 2 packages in 0.33ms

$ uv sync
Resolved 2 packages in 0.70ms
Audited 1 package in 0.02ms

三、更改国内下载镜像

更改国内镜像地址，有以下两种方法，选择其中一种就行。推荐设置全局配置文件uv.toml。

1.编辑uv配置文件

1.1全局配置文件（推荐）

在/etc/uv/目录下设置uv.toml配置文件。以下设置只能对uv安装python工具包起作用，即uv下载pypi工具时，会默认从设置的网站下载。但是对于python解释器的下载，需要另外设置，具体设置就是创建软链接，见为uv设置python解释器。

mkdir /etc/uv

echo '
[[index]]
url = "https://mirrors.aliyun.com/pypi/simple/"
default = true'  > /etc/uv/uv.toml

1.2具体项目的配置文件

在uv目录下设置pyproject.toml配置文件。

vim pyproject.toml

增加以下内容
[[tool.uv.index]]
url = "https://mirrors.aliyun.com/pypi/simple/"

[[tool.uv.index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true

[tool.uv.pip]
index-url = "https://pypi.tuna.tsinghua.edu.cn/simple"

2.直接设置环境参数

有关uv的环境参数名称见官网https://docs.astral.sh/uv/reference/environment/#uv_break_system_packages

echo 'export UV_DEFAULT_INDEX="https://mirrors.aliyun.com/pypi/simple/"' >> ~/.bashrc
echo 'export UV_DEFAULT_INDEX="https://mirrors.aliyun.com/pypi/simple/"' >> ~/.profile
echo 'export UV_DEFAULT_INDEX="https://mirrors.aliyun.com/pypi/simple/"' >> ~/.bash_profile
exec "$SHELL"   # 重启shell，使设置的环境变量生效

四、为uv设置单独的虚拟环境

1.为uv设置python解释器

将pyenv安装的python作为uv的python解释器，创建软连接。uv会优先在环境变量中查找已经安装的python解释器，查找不到，才会从默认的网站下载。其默认的网站一般是国外网站，会因为网速问题导致uv下载python解释器失败。

ln -s  "$HOME/.pyenv/versions/3.12.6/bin/python"  /usr/local/bin/python3.12

2.创建独立的虚拟环境

使用 uv 直接创建并激活虚拟环境。**使用uv venv创建虚拟环境，会自动下载对应的python解释器到以下路径/root/.local/share/uv/python/下。**并且在/opt/dify-python/lib/uv-venv/bin目录中创建软链接指向自动下载的python解释器。

uv venv /path/to/uv-venv
source /path/to/uv-venv/bin/activate

示例：
uv venv /opt/dify-python/lib/uv-venv
source /opt/dify-python/lib/uv-venv/bin/activate

3.退出虚拟环境

deactivate

4.在独立环境中使用 uv

激活虚拟环境后，所有通过 uv pip install 安装的包将仅存在于（每个项目的） ./venv/lib/pythonX.Y/site-packages。安装包（仅影响当前 uv-venv 环境）

uv pip install numpy openai

或者
uv pip install -r requirements.txt  # 安装项目依赖

5.与 poetry 环境完全隔离

poetry 环境：继续在项目目录中通过 poetry install 管理主依赖。

uv 环境：仅在手动激活 uv-venv 后操作，不影响 poetry。

验证隔离性：

检查当前环境的 Python 路径

which python

应输出 uv-venv 的路径，如：/path/to/uv-venv/bin/python

对比两个环境的包列表

在 uv-venv 中：
uv pip list -v   # 列出所有已安装的包及其版本

在 poetry 环境中：
poetry run pip list

总结

到此这篇关于python依赖管理工具UV的安装和使用的文章就介绍到这了,更多相关python依赖管理工具UV安装内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Python实现softmax反向传播的示例代码
这篇文章主要为大家详细介绍了Python实现softmax反向传播的相关资料，文中的示例代码讲解详细，具有一定的参考价值，感兴趣的可以了解一下
2023-04-04
2021年的Python 时间轴和即将推出的功能详解
这篇文章主要介绍了2021年的Python 时间轴和即将推出的功能,本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2020-07-07
pycharm如何debug for循环里面的错误值(推荐)
一般debug时,在for循环里面的话,需要自己一步一步点,如果循环几百次那种就比较麻烦,此时可以采用try except的方式来解决,这篇文章主要介绍了pycharm如何debug for循环里面的错误值,需要的朋友可以参考下
2024-07-07
pandas实现数据合并的示例代码
本文主要介绍了pandas实现数据合并的示例代码，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-05-05
Python实现周期性抓取网页内容的方法
这篇文章主要介绍了Python实现周期性抓取网页内容的方法,涉及Python时间函数及正则匹配的相关操作技巧,具有一定参考借鉴价值,需要的朋友可以参考下
2015-11-11
Python图像运算之图像掩膜直方图和HS直方图详解
这篇文章将为大家详细讲解图像掩膜直方图和HS直方图，并分享一个通过直方图判断白天与黑夜的案例。文中的示例代码讲解详细，感兴趣的小伙伴可以了解一下
2022-08-08
Python深度学习神经网络基本原理
人工神经网络（Artificial Neural Networks，简写为ANNs）也简称为神经网络（NNs）或称作连接模型（Connection Model），它是一种模仿动物神经网络行为特征，进行分布式并行信息处理的算法数学模型
2021-10-10
Python 用户输入和字符串格式化示例详解
Python 允许用户输入数据。这意味着我们可以向用户询问输入，这篇文章主要介绍了Python 用户输入和字符串格式化指南,以下示例要求用户输入用户名，并在输入用户名后将其打印在屏幕上，需要的朋友可以参考下
2023-11-11
python+opencv+selenium自动化登录邮箱并解决滑动验证的问题
本文主要讲解基于python+opencv+selenium自动化登录邮箱并解决滑动验证的问题，在这大家需要注意页面元素定位及文本框和验证码的frame嵌套问题，感兴趣的朋友一起看看吧
2021-07-07
使用Python实现Excel表格转图片
在数据处理与信息分享过程中,Excel表格作为一种强大的数据管理工具被广泛应用,这篇文章主要为大家详细介绍了如何使用Python将Excel表格转换为图片,需要的可以参考下
2024-04-04