UV python包管理工具

发布于:2025-06-24 ⋅ 阅读:(18) ⋅ 点赞:(0)

最近,在学习大模型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博客

常用命令:使用 uv 管理 Python 環境 - DEV Community

创建项目:https://zhuanlan.zhihu.com/p/6776864377


网站公告

今日签到

点亮在社区的每一天
去签到