什么是uv？

uv是一个用 Rust 编写的，极其快速的 Python 包和项目管理器

• 官方文档：uv

• 项目地址： An extremely fast Python package and project manager, written in Rust.

Installation

Install uv with our standalone installers:

# On macOS and Linux.
curl -LsSf https://astral.sh/uv/install.sh | sh

# On Windows.
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

版本管理

安装和管理 Python 本身。

• uv python install ：安装 Python 版本。
• uv python list ：查看可用的 Python 版本。
• UV Python find ：找到已安装的 Python 版本。
• uv python pin：将当前项目钉置为使用特定的 Python 版本。
• uv python uninstall ：卸载 Python 版本。

项目管理

创建和参与 Python 项目，也就是使用 pyproject.toml 的程序。

• uv init ProjectName：创建一个新的 Python 项目。
• UV add：给项目添加依赖。
• uv remove ：从项目中移除依赖。
• uv sync ：将项目的依赖与环境同步。
• uv Lock：为项目的依赖创建锁文件。
• uv run ：在项目环境中运行命令。
• uv tree ：查看项目的依赖树。
• uv build ：将项目集成到分发档案中。
• uv publish ：将项目发布到一个包索引中。

创建虚拟环境

UV 支持创建虚拟环境，例如创建.venv 的虚拟环境：

bash
uv venv

可以指定特定名称或路径，例如，在 my-name 创建虚拟环境：

uv venv my-name

`

可以请求提供 Python 版本，例如，用 Python 3.11 创建虚拟环境：

uv venv --python 3.11

`

注意，这需要系统上有请求的 Python 版本。然而，如果 不可用，UV 会帮你下载 Python。参见 更多细节请参考 Python 版本文档。

使用虚拟环境

激活

• win

.venv\Scripts\activate

linux/mac

source .venv/bin/activate

使用默认虚拟环境名称时，uv 会自动在后续调用中查找并使用该虚拟环境。

uv venv

#Install a package in the new virtual environment 
uv pip install ruff

`
退出环境

deactivate

什么是ruff？

一个用 Rust 编写的极速 Python 代码检查器和格式化工具。（ 为 VS Code和 更多编辑器 提供官方 编辑器集成）

• 官方文档：Ruff - Astral 文档
• 项目地址：ruff: An extremely fast Python linter and code formatter, written in Rust.

ruff添加到项目

uv add --dev ruff

检查项目

uv run ruff check

ruff check # 检查当前目录中的文件
ruff check --fix # 检查当前目录中的文件并修复任何可修复的错误。
ruff check --watch # 实时检查当前项目中的文件
ruff check path/to/code/ #检查 `path/to/code` 中的文件。
 ruff check --help  #常看帮助

格式化代码

uv run ruff format

关于uv和ruff更多的配置本文就不多赘述，感兴趣的自己研究