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

liftword2个月前 (03-06)技术文章9

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是一种简单易学的高级编程语言,它具有清晰的语法和丰富的功能,适用于各种应用领域。本教程将带您从零开始学习Python编程,涵盖基本语法、数据类型、控制流、函数、模块等核心概念,帮助您建立起...

写给新手的一封信 小白怎么学习Python

Python是一种面向对象的编程语言,语法简洁而清晰,具有丰富和强大的类库。对于初学编程者来说,首选Python是个非常棒的选择。1、零基础学编程,用python入门是个不错的选择,虽然国内基本上还是...

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

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

3D点云数据处理简明教程【Python】

近年来,在 AR 和空间计算技术的大力推动下,在 Apple 和 Meta 等大公司的支持下,最近推出了 Apple Vision Pro,3D 理解领域受到越来越多的关注。这个迷人领域的核心是 3D...

Python运算符与表达式

通常你所写出的程序语句(逻辑行)会包含若干表达式。 如 2 + 3即为一个简单的表达式。表达式由运算符与操作数构成。运算符是一些可以用+号或其他关键词符号替代的功能。运算符会对相关数据进行运算,这些被...

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

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