uv 笔记

uv 笔记

简介

Rust写的Python包管理器和项目管理器，号称以一替多、秒杀pip、poetry、virtualenv等；特点：快。

详见官方文档【点击直达】

安装

Windows

1
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

将安装到${user}/.local/bin目录下：

image-20250319143236833

提示安装成功后，关闭命令行窗口重新打开、执行：

1
uv

出现命令使用介绍则安装完成：

image-20250319143504686

注：其他安装方式如pip安装等、以及其他平台的安装方法详见官方文档【点击直达】

常用命令

Python相关

命令 说明
uv python install 安装Python版本
uv python uninstall 卸载Python版本
uv python list 列出可用的Python版本
uv python find 查找安装的Python版本
uv python pin 固定当前项目所使用的Python版本
uv python dir 显示Python安装目录路径

详见官方文档【点击直达】

Script相关

命令 说明
uv run 运行Python脚本
uv add –script 添加依赖至Python脚本
uv remove –script 移除依赖从Python脚本

详见官方文档【点击直达】

Project相关

命令 说明
uv init 创建Python项目
uv add 添加依赖
uv remove 移除依赖
uv sync 将依赖同步到环境
uv lock 为依赖创建一个锁定文件
uv run 在项目环境中运行命令
uv tree 查看项目依赖树
uv build 将项目构建为发布包
uv publish 将项目发布到软件包索引

详见官方文档【点击直达】

工具相关

命令 说明
uv tool run 在临时环境中运行工具
uv tool install 在用户范围内安装工具
uv tool uninstall 卸载工具
uv tool list 列出已安装的工具
uv tool update-shell 将bin目录添加到公共shell配置路径中
uv tool dir 显示工具目录路径

详见官方文档【点击直达】

环境相关

命令 说明
uv venv 创建一个新的虚拟环境

详见官方文档【点击直达】

PIP相关

命令 说明
uv pip install 将软件包安装到当前环境中
uv pip uninstall 卸载软件包
uv pip list 列出已安装的软件包
uv pip show 显示已安装软件包的详细信息
uv pip freeze 列出已安装的软件包及其版本
uv pip check 检查当前环境是否具有兼容的软件包
uv pip tree 查看当前环境的依赖树
uv pip compile 编译成一个锁定文件
uv pip sync 将环境与锁定文件同步

详见官方文档：PIP【点击直达】、锁定环境【点击直达】

其他

命令 说明
uv cache clean 删除缓存
uv cache prune 删除过时的缓存
uv cache dir 显示缓存目录路径
uv self update 更新为最新版本
uv help / uv –help 显示帮助菜单
uv help 显示指定命令的帮助菜单
uv version / uv –version / uv -V 显示已安装的版本信息
uv pip –version 显示已安装的uv-pip版本信息

详见官方文档：缓存【点击直达】

应用实践

创建项目及添加依赖

1
2
3
4
5
6
7
8
9
10
11
# 初始化项目
uv init weather
cd weather

# 创建虚拟环境
uv venv
# 进入虚拟环境
.venv\Scripts\activate

# 添加依赖
uv add mcp[cli] httpx

image-20250319152835693

image-20250319152656536

项目文件目录结构：

image-20250319153033738

通过uv命令运行：

1
uv run main.py

image-20250319153512061

相关链接