1. uv安装

使用curl下载脚本并通过sh执行：

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

如果系统没有curl，可以使用wget

wget -qO- https://astral.sh/uv/install.sh | sh

要为uv命令和uvx命令启用shell自动补全，运行以下对应命令

echo 'eval "$(uv generate-shell-completion bash)"' >> ~/.bashrc

echo 'eval "$(uvx --generate-shell-completion bash)"' >> ~/.bashrc

使用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

2.5 创建虚拟环境

创建一个虚拟环境，并指定Python版本

uv venv my-name --python 3.11

2.6 激活虚拟环境

source .venv/bin/activate

2.7 退出虚拟环境

deactivate

2.8 在uv中使用pip

uv pip install

3. 换源

通过配置uv的原生配置文件，无论是uv pip还是uv add都能直接生效

mkdir -p ~/.config/uv

vim ~/.config/uv/uv.toml

写入

[[index]]
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
default = true

4. 使用Jupyter

使用如下指令即可运行Jupyter

uv run --with jupyter jupyter lab

官方文档

中文文档