UV工具的安装与使用

最新推荐文章于 2025-06-22 15:02:19 发布

秦始皇爱找茬

最新推荐文章于 2025-06-22 15:02:19 发布

阅读量3.3k

点赞数 7

CC 4.0 BY-SA版权

文章标签： uv python pip

本文链接：https://blog.csdn.net/zhangshaohua1603/article/details/147552677

文章目录

- 概要
- UV的优势
- UV工具快速使用
- UV常用命令

介绍

uv是一个python包管理的现代工具，它只在替代pipvirtualenv,提供更快、更高效的包安装与虚拟环境管理体验，uv是有Astral团队开发，并逐渐成为python社区中的热门替代工具。

简而言之，uv 是一个超快的 Python 包管理器，它集成了：

包安装（替代 pip）
虚拟环境管理（替代 virtualenv）
锁定文件（兼容 pip-tools 和 Poetry）

UV的优势

🚀 极快的安装速度：基于 Rust 实现，速度比 pip 快上几十倍
📦 自动创建虚拟环境：类似 Poetry，无需手动激活
🔐 锁定依赖：生成 uv.lock 文件，确保可重复构建
🐍 兼容性强：兼容 pyproject.toml，无缝对接现有项目
📁 缓存机制优秀：充分利用缓存，加快安装流程

UV工具快速使用

1.安装 UV

如果电脑中安装过Python，可以直接使用pip命令安装：

pip install uv

2.初始化项目

创建一个空文件夹
切换到对应文件夹下，输入uv init即可初始化uv工程

uv工程默认会生成5个文件：

.gitignore：git排除不需要跟踪的文件

.python-version：记录当前工程的Python版本。

main.py：主脚本。

pyproject.toml：记录当前uv工程的依赖情况。

README.md：工程的说明文件。

3.生成虚拟环境

方式一：为项目初始化一个Python虚拟环境，并且可以指定Python解释器版本

uv venv --python 3.12

方式二：可以通过以下命令直接创建工程并指定python解释器版本

uv init test_uv -p 3.12

4.激活虚拟环境

输入以下命令即可激活虚拟环境

.\.venv\Scripts\activate

UV常用命令

创建和处理 Python 项目，即使用 pyproject.toml

uv init：创建新的 Python 项目。    
uv add：向项目添加依赖项。    
uv remove：从项目中删除依赖项。    
uv sync：将项目的依赖项与环境同步。    
uv lock：为项目的依赖项创建一个 lockfile。    
uv run：在项目环境中执行命令。    
uv tree：查看项目的依赖关系树。    
uv build：将项目构建到分发存档中。    
uv publish：将项目发布到包索引。

安装和管理 Python 本身

uv python install：安装 Python 版本。
uv python list：查看可用的 Python 版本。
uv python find：查找已安装的 Python 版本。
uv python pin：固定当前项目以使用特定的 Python 版本。
uv python uninstall：卸载 Python 版本。

执行独立的 Python 脚本，例如 example.py

uv run：运行脚本。    
uv add --script：向脚本添加依赖项    
uv remove --script：从脚本中删除依赖项