前言

记录一下 uv 的使用方法。曾经几次用到，但是都忘记怎么用了，又要回去翻文档，在这里写篇文章记下来…
更详细的使用方法请参考中文官方文档

下载 uv

通过 pip 下载

最简单的办法就是通过 pip 下载了

1
pip install uv

通过 PowerShell 等独立下载

当然 uv 还提供了独立的安装程序用于下载和安装，没有 pip 就可以使用这个方法

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

常见问题

下载的 uv 有概率在使用时找不到 uv.exe ，这个时候就需要手动添加环境变量，来确保系统找得到 uv.exe

使用 uv

这里会有两种使用方法

创建新的 python 项目

创建和开发带有 pyproject.toml 的 Python 项目中常用的命令行

  • uv init: 创建新 Python 项目
  • uv add: 为项目添加依赖
  • uv remove: 从项目移除依赖
  • uv sync: 同步项目依赖到环境
  • uv lock: 为项目依赖创建锁文件
  • uv run: 在项目环境中运行命令
  • uv tree: 查看项目依赖树
  • uv build: 构建项目为分发包
  • uv publish: 发布项目到包索引

创建新项目时使用uv init初始化，然后使用uv add/remove添加或者移除依赖

使用别人的项目同步环境时则使用uv sync来下载依赖

uv pip list列出已安装包

运行以前没有使用 uv 的项目

创建虚拟环境

1
uv venv

剩下的基本于 pip 命令相似，只需要在前面加上 uv，例如:

  • uv pip install：将包安装到当前环境
  • uv pip list：列出已安装包
  • …

激活虚拟环境

1
.venv\Scripts\activate

同步依赖

1
2
# 使用 uv 安装依赖（速度更快）
uv pip install -r requirements.txt

结语

uv 使用起来是非常方便的。如果是开发的话，使用 uv 不管是创建环境也好，同步环境也好，就一句命令的问题，也不需要担心项目依赖打架。用起来感觉跟 npm 差不多的使用体验 (性能上感觉比 npm 要好，当然 npm 基础上还有个性能更好的 pnpm，但是我还没怎么使用过)。由于不是经常写 python 的代码，偶尔要用到的时候会忘记基础的命令行，于是写下这篇文章进行记录。测试什么的就懒得写了，基本上都是什么... --version或者... -v。