1. uv安装

直接使用Python自带的pip安装，兼容性最佳

pip install uv

随后将pip安装的包导入到环境变量中，在.bashrc或者.zshrc中添加

export PATH="$HOME/.local/bin:$PATH"

使用source ~/.zshrc刷新

2. 基础用法

2.1 创建项目

首先设定python版本

uv python pin 3.13
uv init

2.2 添加依赖

添加numpy库

uv add numpy

添加指定版本的numpy库

uv add numpy>=2.0.2

2.3 移除依赖

移除numpy库

uv remove numpy

2.4 查看项目的依赖树

uv tree

3. 换源

uv换源包括两个方面一个是依赖包的源另一个是python的源

在.zshrc中更换python源

export UV_PYTHON_INSTALL_MIRROR=https://ghproxy.cn/https://github.com/indygreg/python-build-standalone/releases/download

在项目中的pyproject.toml文件中更换依赖包源

[tool.uv]
index-url = "https://pypi.tuna.tsinghua.edu.cn/simple/"

4. 安装pytorch

这里以安装pytorch-cu124版本为例

在pyproject.toml文件中添加如下内容

[project]
...
dependencies = [
     "torch>=2.4.0",
     "torchvision>=0.22.0",
     ...
]
[tool.uv.sources]
torch = [
  { index = "pytorch-cu124" },
]
torchvision = [
    { index = "pytorch-cu124" },
]
[[tool.uv.index]]
name = "pytorch-cu124"
url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple"
explicit = true

然后同步项目依赖

uv sync

5. 使用Jupyter

使用如下指令即可运行Jupyter

uv run --with jupyter jupyter lab

官方文档