最近,在学习大模型MCP相关知识时,接触到了UV这个python包的管理工具,网上说比pip、conda、poetry等工具好用,为了验证效果,尝试安装使用一下。
一、安装
分别使用pip、powershell两种方式举例说明一下。网友推荐用powershell安装,此种安装方式,不依赖已经安装的python环境。
1、使用pip安装
适用已经安装pip工具,或者conda中安装了pip工具的场景
命令:pip install uv
查看uv安装到了哪里
命令:pip show uv
2、使用powershell 安装
在命令行终端直接执行下面命令,安装过程及环境变量配置参考:https://zhuanlan.zhihu.com/p/1906678845215581957
命令:powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
指定路径安装,其中"D:\Custom\Path"是指定的安装路径,可修改
命令:powershell -ExecutionPolicy ByPass -c {$env:UV_INSTALL_DIR = "D:\Custom\Path";irm https://astral.sh/uv/install.ps1 | iex}
3、配置环境变量
安装完成后,使用下面三个命令查看python包、工具包和缓存路径,发现都在C盘,可以通过配置环境变量,修改其路径
命令:
uv python dir
uv tool dir
uv cache dir
在系统环境变量中添加三个环境变量
注意:添加完成后,需要重启电脑
重启后,查询是否修改成功
4、加速python包的下载
在D:\soft\uv_env、D:\soft\uv_env\python、C:\Users\[你的用户名]\AppData\Roaming\uv都中添加uv.toml文件(因为不知道添加在哪里生效的,所有三个地方都加了),内容如下:
index-url = "https://mirrors.aliyun.com/pypi/simple/"
二、卸载
命令:pip uninstall uv
三、常用命令
1、版本管理:
- uv python list:查看已安装的Python版本
- uv python install <version>:安装指定版本的Python,版本号可以是0个或多个,如果不指定安装最新版本。例如,uv python install 3.11 3.12
- uv python uninstall <version>:卸载指定版本的Python
- uv python find <version>:查找使用uv安装的Python 版本
- uv python dir:查找python安装目录
- uv python pin <version>:将当前项目锁定到指定版本的Python。例如,uv python pin 3.12.0
2、安装和更新包:
- uv pip install package_name:安装指定包。例如,uv pip install numpy
- uv pip install package_name==version:安装指定版本的包。例如,uv pip install requests==2.26.0
- uv pip install --upgrade package_name:升级已安装的包。例如,uv pip install --upgrade requests
3、卸载包:
- uv pip uninstall package_name:删除已安装的包。例如,uv pip uninstall numpy
4、依赖管理:
- uv sync:根据pyproject.toml或requirements.txt安装依赖,并生成或更新uv.lock文件
- uv sync --onlyprod:仅安装生产依赖
- uv sync --onlydev:仅安装开发依赖
- uv pip freeze > requirements.txt:生成当前环境的依赖列表
- uv pip install -r requirements.txt:根据requirements.txt文件安装所有依赖
5、项目管理命令:
- uv init <project_name>:初始化新项目
- uv add <package_name>:向项目添加依赖项
- uv remove <package_name>:从项目中删除依赖项
- uv lock --script:更新项目的锁文件
- uv tree:显示项目的依赖树
6、虚拟环境管理:
- uv venv --python=<version>:创建虚拟环境并指定Python版本。例如,uv venv --python=3.12.0 .venv
- source .venv/bin/activate(Linux/macOS)或.venv\Scripts\activate(Windows):激活虚拟环境
- uv run script.py:自动激活虚拟环境并执行脚本
四、创建项目
1、创建项目文件夹:E:\UVProject\learn\test_proj
2、打开终端,在命令行中进入test_proj目录
3、初始化,并指定python版本
完成后,test_proj目录下为多出一些文件
项目使用的python版本,在pyproject.toml文件中查看
4、配置镜像源
在pyproject.toml添加下面内容
[[index]]
url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
default = true
5、安装包
使用 uv add pandas 或者 uv pip install pandas 命令安装包
安装完成后test_proj文件夹下会多出一个 .venv 文件夹,其中pyvenv.cfg中可以查看python工具的路径。
参考资料:
uv官网文档:Installer | uv
环境变量配置:https://juejin.cn/post/7495414240359104549 、 https://juejin.cn/post/7486873121695449128#heading-1
python包加速下载:记录一下windows使用python中uv工具安装包缓慢的问题_windows安装uv-CSDN博客