【笔记】uv学习笔记

发表于 阅读次数：

前言

An extremely fast Python package and project manager, written in Rust.（官网）

安装uv

Windows

1
choco install uv

查看帮助

1
uv --help

初始化项目

通过uv管理虚拟环境

  • 通过uv初始化Python项目时会自动创建Python虚拟环境.venv
1
2
uv init <project_name>
cd <project_name>

手动管理虚拟环境

1
2
3
4
mkdir <project_name>
cd <project_name>
uv venv
source .venv/bin/activate

手动管理依赖

  • 通过uv pip手动管理依赖时，不会自动修改pyproject.toml文件
1
uv pip install <package_name>

添加所有依赖

  • 根据pyproject.toml文件添加所有依赖

--sync：只添加开发依赖
--no-dev：只添加运行时依赖不添加开发依赖，缺省值为添加运行时依赖和开发依赖

1
uv sync
  • 根据requirements.txt文件添加所有依赖
1
uv pip install -r requirements.txt

添加指定依赖

--dev：添加开发依赖

1
uv add <package_name>

指定版本

1
uv add numpy==<version>

删除依赖

--dev：删除开发依赖

1
uv remove <package_name>

查看可更新依赖

1
uv outdated

查看已安装依赖列表

1
uv list

查看已安装依赖树

1
uv tree

依赖冲突检查

1
uv check

将requirements.txt转换为pyproject.toml

1
uv init --requirements requirements.txt

运行源码

1
uv run python main.py

运行开发工具

单元测试

1
uv run pytest

代码格式化

1
uv run ruff format

缓存

清理缓存

1
uv cache clean

Python版本管理

查看所有已安装的版本

1
uv python list

查看所有可安装的版本

1
uv python list --all

安装指定Python版本

1
uv python install <version>

卸载指定版本

1
uv python uninstall <version>

锁定项目Python版本

1
uv python pin <version>

完成