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!

4. 修改代码及添加依赖

# 重命名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