uv使用笔记

✅ 常用命令

功能说明	命令
1.创建虚拟环境	uv venv --python 3.9 或 uv venv
2.生成一个 pyproject.toml 文件	uv init
3.安装 pyproject.toml 文件中的依赖	uv sync
生成锁文件 uv.lock	uv lock
根据锁文件安装精确版本	uv sync --frozen
4.安装包	uv add 包名
5.卸载包	uv remove 包名
6.激活虚拟环境（Windows）	.\.venv\Scripts\activate

“uv”是指 **uv**，是一个用 Rust 编写的极其快速且功能强大的 Python 包和项目管理器，由 Astral 公司（创建 Ruff 的公司）开发。也支持虚拟环境创建和依赖管理。

🔧 一、安装 uv

uv 是一个跨平台的命令行工具，目前支持 macOS、Linux 和 Windows。

1. 安装方法

# 1.官方推荐安装脚本
# On Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

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

# 2.pip安装（有局限性，会安装在Python目录中）
pip install uv

# 安装后检查版本
uv --version

安装之后，把C:\Users\[用户名]\.local\bin\ 目录添加到系统环境变量，再查看版本，或通过 Get-Command uv命令查看 uv 的完整路径。

二、使用 uv 创建虚拟环境

uv 支持像 python -m venv 一样创建虚拟环境，而且支持自动检测系统 Python，也可以指定 Python 版本。

# 在当前目录下创建一个默认名为 .venv 的虚拟环境。
uv venv

# 自定义虚拟环境名称为 venv_test
uv venv venv_test

# 默认创建的python版本是最新的，也可以指定python的版本
uv venv --python 3.9

三、激活虚拟环境

创建好虚拟环境之后，激活方式和普通 venv 一样（不同系统有差异）：

# Windows
venv_test\Scripts\activate

# Linux/macOS
source venv_test/bin/activate

激活之后，你的终端会显示虚拟环境名称，说明你已经进入虚拟环境了。

在VS Code中直接选择解释器在 .venv目录中的 python.exe 就可以了。

四、安装包依赖

可以用 uv pip install 或 uv add 来安装包，就像普通的 pip 一样，但速度更快。
比如安装 requests：

uv pip install requests
uv add requests

uv 支持很多命令，比如：

• uv pip install
• uv pip uninstall
• uv pip list
• uv pip compile requirements.in -o requirements.txt
• uv pip sync requirements.txt

它完全兼容 pip 的用法，但性能更高。

五、创建一个新项目结构

你可以手动创建一个 Python 项目的结构，比如：

mkdir myproject
cd myproject
uv venv

然后激活虚拟环境，再安装依赖：

source .venv/bin/activate
uv add flask

六、配合 pyproject.toml 使用（现代项目标准）

如果你希望使用 pyproject.toml 来管理项目依赖，可以使用：

uv init

这会生成一个 pyproject.toml 文件，你可以手动添加依赖：

[project]
name = "myproject"
version = "0.1.0"
dependencies = [
    "flask",
    "requests",
]

然后使用以下命令安装所有依赖：

uv install

类似于 pip install -e . 的效果。

七、与编辑器集成（如 VSCode）

你可以在 VSCode 中选择解释器为新创建的虚拟环境的 Python 路径。例如：

• 如果你在项目目录下创建了 .venv，那么 VSCode 的 Python 解释器应该选择：
  • Linux/macOS: .venv/bin/python
  • Windows: .venv\Scripts\python.exe

在 VSCode 中按 Ctrl + Shift + P，输入 “Python: Select Interpreter”，选择即可。

八、删除虚拟环境

直接删除 .venv 目录即可：

# Windows 下直接删除文件夹
# Linux
rm -rf .venv

✅ 小结

功能	命令
安装 uv	curl -Ls https://install.uv.rs	sh
创建虚拟环境	uv venv 或 uv venv venv_test或 uv venv --python 3.9
激活虚拟环境（Linux/macOS）	source venv_test/bin/activate
激活虚拟环境（Windows）	venv_test\Scripts\activate
安装依赖	uv add 包名或uv pip install 包名
初始化项目	uv init 生成一个 pyproject.toml 文件
安装项目依赖	uv install
删除虚拟环境	删除文件夹即可

uv 官方文档：https://docs.astral.sh/uv/