Python uv 加速

使用 uv 替代 pip/pip-tools/virtualenv，显著提升 Python 依赖安装速度。

Instructions（分步说明）

Step 1：检测项目类型

检查项目是否为 Python 项目：

```
requirements.txt
```
— 传统依赖文件
```
pyproject.toml
```
— 现代 Python 项目配置
```
setup.py
```
/
```
setup.cfg
```
— 传统打包配置
```
.py
```
文件 — Python 源码

检查项目是否为 Python 项目：

```
requirements.txt
```
— 传统依赖文件
```
pyproject.toml
```
— 现代 Python 项目配置
```
setup.py
```
/
```
setup.cfg
```
— 传统打包配置
```
.py
```
文件 — Python 源码

Step 2：虚拟环境创建

默认使用 uv 创建虚拟环境，替代

python -m venv

：

bash

undefined

默认使用 uv 创建虚拟环境，替代

python -m venv

：

bash

undefined

✅ 推荐：使用 uv（极速）

uv venv

❌ 避免：传统方式（较慢）

python -m venv venv


默认创建 `.venv/` 目录。如需指定名称：

```bash
uv venv venv  # 创建 venv/ 目录

python -m venv venv


默认创建 `.venv/` 目录。如需指定名称：

```bash
uv venv venv  # 创建 venv/ 目录

Step 3：依赖安装

默认使用 uv pip 安装依赖，替代

pip install

：

bash

undefined

默认使用 uv pip 安装依赖，替代

pip install

：

bash

undefined

✅ 推荐：使用 uv（极速，利用全局缓存）

uv pip install -r requirements.txt

单个包安装

uv pip install requests

开发模式安装

uv pip install -e .

❌ 避免：传统方式（较慢）

pip install -r requirements.txt

undefined

pip install -r requirements.txt

undefined

Step 4：常用命令对照

传统命令	uv 替代命令	说明
`python -m venv venv`	`uv venv`	创建虚拟环境
`pip install -r requirements.txt`	`uv pip install -r requirements.txt`	安装依赖
`pip install package`	`uv pip install package`	安装单个包
`pip install -e .`	`uv pip install -e .`	开发模式安装
`pip freeze`	`uv pip freeze`	导出依赖
`pip list`	`uv pip list`	列出已安装包
`pip uninstall package`	`uv pip uninstall package`	卸载包

传统命令	uv 替代命令	说明
`python -m venv venv`	`uv venv`	创建虚拟环境
`pip install -r requirements.txt`	`uv pip install -r requirements.txt`	安装依赖
`pip install package`	`uv pip install package`	安装单个包
`pip install -e .`	`uv pip install -e .`	开发模式安装
`pip freeze`	`uv pip freeze`	导出依赖
`pip list`	`uv pip list`	列出已安装包
`pip uninstall package`	`uv pip uninstall package`	卸载包

Step 5：确保 .gitignore 配置

虚拟环境目录应加入

.gitignore

：

gitignore

undefined

虚拟环境目录应加入

.gitignore

：

gitignore

undefined

虚拟环境（uv 默认创建 .venv/）

.venv/ venv/ env/ ENV/

---

.venv/ venv/ env/ ENV/

---

Examples（示例）

示例 1：新建 Python 项目

bash

undefined

bash

undefined

创建虚拟环境

uv venv source .venv/bin/activate

安装依赖

uv pip install flask requests

导出依赖

uv pip freeze > requirements.txt

undefined

uv pip freeze > requirements.txt

undefined

示例 2：克隆现有项目后初始化

bash

git clone https://github.com/user/project.git
cd project

bash

git clone https://github.com/user/project.git
cd project

创建虚拟环境并安装依赖

uv venv source .venv/bin/activate uv pip install -r requirements.txt

undefined

uv venv source .venv/bin/activate uv pip install -r requirements.txt

undefined

示例 3：使用 pyproject.toml 的项目

bash

uv venv
source .venv/bin/activate

bash

uv venv
source .venv/bin/activate

安装项目及其依赖

uv pip install -e ".[dev]"

---

uv pip install -e ".[dev]"

---

Edge Cases（边界情况）

uv 未安装

如果系统未安装 uv，先安装：

bash

undefined

如果系统未安装 uv，先安装：

bash

undefined

Linux/macOS

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

Windows (PowerShell)

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

或使用 pip 安装

pip install uv

undefined

pip install uv

undefined

需要特定 Python 版本

uv 支持指定 Python 版本：

bash

uv venv --python 3.11

uv 支持指定 Python 版本：

bash

uv venv --python 3.11

私有包源

uv 支持自定义包源：

bash

uv pip install --index-url https://pypi.example.com/simple/ package

uv 支持自定义包源：

bash

uv pip install --index-url https://pypi.example.com/simple/ package

与 poetry/pdm 项目兼容

uv 可以与

pyproject.toml

配合使用，但不替代 poetry/pdm 的完整项目管理功能。对于复杂项目，可以：

使用 uv 加速依赖安装部分
或继续使用 poetry/pdm 的完整工作流

uv 可以与

pyproject.toml

配合使用，但不替代 poetry/pdm 的完整项目管理功能。对于复杂项目，可以：

使用 uv 加速依赖安装部分
或继续使用 poetry/pdm 的完整工作流

参考资料

详细命令和高级用法见 references/uv-commands.md。

python-uv-acceleration

Original

Translation

Python uv 加速

Python uv 加速

Instructions（分步说明）

Instructions（分步说明）

Step 1：检测项目类型

Step 1：检测项目类型

Step 2：虚拟环境创建

Step 2：虚拟环境创建

✅ 推荐：使用 uv（极速）

✅ 推荐：使用 uv（极速）

❌ 避免：传统方式（较慢）

❌ 避免：传统方式（较慢）

Step 3：依赖安装

Step 3：依赖安装

✅ 推荐：使用 uv（极速，利用全局缓存）

✅ 推荐：使用 uv（极速，利用全局缓存）

单个包安装

单个包安装

开发模式安装

开发模式安装

❌ 避免：传统方式（较慢）

❌ 避免：传统方式（较慢）

Step 4：常用命令对照

Step 4：常用命令对照

Step 5：确保 .gitignore 配置

Step 5：确保 .gitignore 配置

虚拟环境（uv 默认创建 .venv/）

虚拟环境（uv 默认创建 .venv/）

Examples（示例）

Examples（示例）

示例 1：新建 Python 项目

示例 1：新建 Python 项目

创建虚拟环境

创建虚拟环境

安装依赖

安装依赖

导出依赖

导出依赖

示例 2：克隆现有项目后初始化

示例 2：克隆现有项目后初始化

创建虚拟环境并安装依赖

创建虚拟环境并安装依赖

示例 3：使用 pyproject.toml 的项目

示例 3：使用 pyproject.toml 的项目

安装项目及其依赖

安装项目及其依赖

Edge Cases（边界情况）

Edge Cases（边界情况）

uv 未安装

uv 未安装

Linux/macOS

Linux/macOS

Windows (PowerShell)

Windows (PowerShell)

或使用 pip 安装

或使用 pip 安装

需要特定 Python 版本

需要特定 Python 版本

私有包源

私有包源

与 poetry/pdm 项目兼容

与 poetry/pdm 项目兼容

参考资料

参考资料