Python开发管理神器--UV 使用教程:从安装到项目管理

liftword4个月前 (03-06)技术文章23

UV 是一个用 Rust 编写的高效 Python 包和项目管理工具,提供了比传统工具更快的速度和更强的功能。本文将指导你如何使用 UV 从安装到运行一个 Python 项目。

重点:它可以独立安装,可以不依赖python环境,跨平台,即下载即使用。也就是说,可以单独安装,也可以使用PIP来安装。

1. 安装 UV

通过独立安装程序

macOS 和 Linux:

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

Windows:

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

##如果出错,也可以使用以下命令安装:
powershell -ExecutionPolicy ByPass -c "irm https://github.com/astral-sh/uv/releases/download/0.5.7/uv-installer.ps1 | iex"

## 或者直接下载可执行文件,放到合适的目录中,即可运行。
https://github.com/astral-sh/uv/releases

通过 PyPI 安装

  • 使用 pip:
pip install uv
  • 使用 pipx:
pipx install uv

2. 安装 Python

UV 支持快速安装和管理多个 Python 版本:

uv python install 3.10 3.11 3.12

查看已安装和可用的 Python 版本:

uv python list

3. 创建新项目

uv init demo01 && uv add "fastapi>=0.112"
# 运行之后,uv会创建demo01目录,并且会添加fastapi依赖,还会在当前目录下新建虚拟环境.venv

# 会自动新建hello.py文件
cd demo01
uv run python hello.py
# 会打印hello from demo01!
  1. 修改代码及添加依赖
# 重命名hello.py为main.py,内容修改如下:

import requests
from rich.pretty import pprint

def main():
    resp = requests.get("https://peps.python.org/api/peps.json") 
    data = resp.json()
    pprint([(k, v["title"]) for k, v in data.items()][:10])


if __name__ == "__main__":
    main()

执行以下命令给main.py添加依赖:

uv add --script main.py requests<3 rich

然后运行此代码:

 uv run python main.py
 
 #运行结果类似以下输出:
 [
  ('1', 'PEP Purpose and Guidelines'),
  ('2', 'Procedure for Adding New Modules'),
  ('3', 'Guidelines for Handling Bug Reports'),
  ('4', 'Deprecation of Standard Modules'),
  ('5', 'Guidelines for Language Evolution'),
  ('6', 'Bug Fix Releases'),
  ('7', 'Style Guide for C Code'),
  ('8', 'Style Guide for Python Code'),
  ('9', 'Sample Plaintext PEP Template'),
  ('10', 'Voting Guidelines')
]

另外,如果是使用git下载好的python项目,可使用以下命令来创建虚拟环境并安装pyproject.toml所需要的依赖。

uv sync --reinstall

或者使用以下命令来安装requirements.txt 依赖:

uv pip install -r requirements.txt

以下为简明参考内容:

python 环境相关命令

uv python install:使用 uv 安装 python。如果你的系统上已经安装了 Python,则无需使用该命令安装 Python,uv 能检测并使用安装的 Python。

uv python list:查看可用的或已安装的 Python 版本。

uv init:初始化一个新项目。新项目的目录下会生成 pyproject.toml、.python-version 文件。

uv venv:创建虚拟环境。虚拟环境的默认位置为当前目录的 .venv;与 pip 创建虚拟环境相比,uv 增加了 CACHEDIR.TAG 文件,以便在未来进行备份或归档操作时,不会将虚拟环境目录中的文件备份或归档。

uv add:下载依赖项并添加到项目中。相比于 pip install,uv add 提供了更高层次的自动化,能自动管理虚拟环境和更新 .pyproject.toml 文件。

uv tree:查看项目的依赖关系树。相比于 pip list,uv tree 提供了更详细的依赖关系信息,且能以树状结构展示。

uv remove:从项目中删除依赖项。相比于 pip uninstall,uv remove 提供更智能的依赖管理,在卸载指定包后,还会检测并删除未使用的依赖项。

管理和运行 python 项目命令:

uv run:运行 python 项目或脚本。(在不显式激活虚拟环境的情况下)它能让你在项目的虚拟环境中执行任何命令或脚本。

uv pip:使用与 pip 兼容的接口管理 Python 包。uv pip提供了更简便、自动化的方式来管理依赖和虚拟环境,而原生的 pip 虽然更灵活但却需要开发者管理多个步骤。

uvx:运行 Python 包提供的命令。它是 uv tool run 的简写,能调用 Python 包中的实用工具,并且不会影响当前项目环境,类似于 pipx。

uv export:将项目的锁文件导出为其他格式,如 requirements.txt。


部分内容引用:
https://blog.csdn.net/edwinjhlee/article/details/141997289

相关文章

怎样学python最简单也最快?

下面是一些学习 Python 最简单且最快的方法:精简学习内容:选择一本最适合自己的 Python 入门级教程,抓住教程核心,跟着教程逐步学习,不要切换太多的学习资源。开篇时可以选择一个简明通俗的 P...

8个python自学网站,一周就可以练熟Python,真的是是小白的福音

人工智能必将到来,在那个时代,我们的工作方式会发生很大的改变,尤其是Python都已经进入了中小学教育的大纲,在智能为主的时代,Python就像现在的电脑一样,每个人工作中必备的工作技能,学会pyth...

高效编码的 Python 技巧和窍门

提示 1:虚拟环境设置虚拟环境以隔离项目依赖关系。它将项目的依赖项与系统范围的依赖项分开,确保一个干净且可重现的环境。# Create a virtual environment python -m...

python实现微信群消息自动转发简明教程

基本思路是,用 Python 模拟微信网页版登陆,接收到群里消息后,对文本、图片、分享等各类消息类型分别处理,并转发至其他群。主要源头是使用itchat,itchat是一个开源的微信个人号接口,pyt...

Python编程:如何搞定生成器(Generator)及表达式?来盘它

前言在前面的篇章中,我们学习了迭代器,这是一个很好的工具,特别是当你需要处理大型数据集时。然而,在Python中构建自己的迭代器有点麻烦和耗时。你必须定义一个实现迭代器协议(__iter__()和__...

python推导式(comprehensions)

推导式是可以从一个数据序列构建另一个新的数据序列的结构体。 推导式在Python2和3中都有支持,有下列几种推导式:列表(list)推导式字典(dict)推导式集合(set)推导式生成器(genera...