UV_Python的简单使用

一、安装uv

在 macOS 上安装

推荐使用 Homebrew 安装：

1
brew install uv

或者使用官方安装脚本：

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

在 Linux 上安装

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

在 Windows 上安装

推荐 使用 Winget：

1
winget install uv

或者使用官方安装脚本：

1
irm https://astral.sh/uv/install.ps1 | iex

安装完成后，验证安装是否成功：

1
uv --version

输出内容类似如下，表明安装成功：

1
uv 0.8.14 (Homebrew 2025-08-28)

在VScode中使用uv

1、uv安装完成后，需要重启vscode，使得vscode的终端环境生效
2、进入项目文件夹, 在执行下面的命令,初始化uv环境
初始化uv环境的时候并指定了python解释器版本

1
uv init --python 3.13

3、修改pyproject.toml文件, 让项目使用国内镜像源

1
2
3
4
5
6
7
8
9
10
11
12
# 项目基础信息
[project]
name = "your-project-name"
version = "0.1.0"
description = "Add your description here"
readme = "README.md"
requires-python = ">=3.13"
dependencies = []

# uv 全局配置（仅给 uv add 使用）
[tool.uv]
index-url = "https://mirrors.aliyun.com/pypi/simple/"

4、运行创建uv虚拟环境命令
创建虚拟环境的时候会自动读取pyproject.toml的Python版本要求

1
uv venv

5、测试激活当前环境（windwos为例）

1
.\.venv\Scripts\activate

若vscode终端提示：
无法加载文件 D:\\Desktop\\xxxxxx\\xxxxxx.venv\\Scripts\\activate.ps1，因 为在此系统上禁止运行脚本。有关详细信息，请参阅

则执行（宽限权限，使得本地脚本随便跑，网上下来的要签名，只影响当前用户）：

1
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
1
2
激活环境（macOS/Linux）
source .venv/bin/activate

6、退出当前激活的uv环境

1
deactivate

7、包管理

1
2
3
4
5
6
7
8
# 安装最新版本
uv pip install requests

# 安装特定版本
uv pip install requests==2.31.0

# 从 requirements.txt 安装
uv pip install -r requirements.txt

8、项目管理

uv 支持 pyproject.toml 格式的项目管理，这是现代 Python 项目的标准配置文件。

初始化一个新项目：

1
2
uv init my_project
cd my_project

这会创建基本的项目结构和 pyproject.toml 文件。

安装项目的依赖：

1
uv sync

这个命令会根据 pyproject.toml 和 requirements.txt 安装所有依赖，类似于 pip install -e . 但更高效。

说明：

uv sync 是一个依赖管理命令，它的作用类似于您可能更熟悉的 pip install -r requirements.txt，但更快、更强大、更可靠。

您可以把它理解为：”一键安装这个项目正常运行所需的所有第三方软件包（依赖库）”。

uv sync 如果安装太慢，可以设置国内镜像源 https://pypi.tuna.tsinghua.edu.cn/simple：

在项目根目录的 pyproject.toml 文件 [tool.uv] 处设置 index-url：

1
2
[tool.uv]
index-url = "https://pypi.tuna.tsinghua.edu.cn/simple"

uv 的优势

  • 速度极快：由于使用 Rust 编写，uv 的性能远超 pip 和其他包管理工具，安装依赖的速度可以提升 10-100 倍。
  • 功能集成：集成语法分析、依赖解析、包安装、环境管理和 Python 版本管理于一体，无需再安装和学习多个工具。
  • 确定性构建：uv 会生成 uv.lock 文件，确保在任何环境中都能安装完全相同的依赖版本，避免 “在我机器上能运行” 的问题。
  • 与现有工具兼容：uv 可以处理 requirements.txt 和 pyproject.toml，可以无缝替代现有工作流中的 pip。

迁移到 uv

如果你正在使用其他工具，可以轻松迁移到 uv：

对于使用 pip + virtualenv 的项目：

1
2
3
4
5
6
# 创建并激活 uv 虚拟环境
uv venv
source .venv/bin/activate

# 安装依赖
uv pip install -r requirements.txt

对于使用 pip-tools 的项目：

1
2
uv pip compile requirements.in -o requirements.txt
uv pip sync

对于使用 poetry 或 pdm 的项目：

1
2
# 直接使用现有的 pyproject.toml
uv sync