# uv 在 Python 开发中的常用命令详解

在 Python 开发中，`uv` 是一个兼具速度与现代化的包管理工具，它可以替代传统的 `pip`、`virtualenv`、`pip-tools` 等工具。本文将介绍 `uv` 在实际开发中的常用命令及其中文解释，帮助你快速上手并高效管理项目依赖。

---

## ✨ 什么是 uv？

[`uv`](https://github.com/astral-sh/uv) 是由 Astral 团队推出的一款极速包管理器，特点如下：

- 🚀 **速度极快**：比 `pip` 安装依赖快数倍
- 📦 **内置虚拟环境管理**：无需 `python -m venv`
- 🔁 **支持锁文件同步**：像 `pip-sync` 一样保证环境一致
- 🧼 **自动缓存和依赖优化**

---

## 📦 安装 uv

使用 pip 安装：

```bash
pip install uv

安装后确认版本

uv --version

🛠️ 常用命令详解

1️⃣ 创建虚拟环境

uv venv

在当前目录创建 .venv 虚拟环境（类似 python -m venv .venv），无需手动激活，uv 命令会自动识别并使用它。

2️⃣ 安装单个依赖包

uv pip install fastapi

替代 pip install，支持 PyPI、GitHub、wheel、压缩包等多种安装方式。

3️⃣ 从 requirements.txt 安装依赖

uv pip install -r requirements.txt

安装项目所需全部依赖，适用于新项目环境初始化。

4️⃣ 升级已有包

6️⃣ 查看当前安装的包

uv pip list

显示当前虚拟环境中所有已安装的库及版本。

7️⃣ 导出依赖（冻结）

uv pip freeze > requirements.txt

导出当前环境下所有包及精确版本，生成 requirements.txt，用于部署或还原环境。

8️⃣ 同步锁定依赖（高级用法）

uv sync

根据 requirements.txt 或 requirements.lock 精确安装依赖，保持团队环境一致（类似 pip-sync）。

9️⃣ 查看包信息

uv pip show fastapi

显示某个包的详细信息，包括安装路径、版本、依赖等。

🔟 清理缓存

uv pip cache purge

清空下载缓存，释放磁盘空间

🧪 快速示例：FastAPI 项目初始化

uv venv
uv pip install fastapi uvicorn
uv pip freeze > requirements.txt
uvicorn main:app --reload

✅ 总结

📌 建议

• 将 uv 设置为默认包管理器，能显著提升开发效率

• 配合 requirements.txt 或 pyproject.toml 使用效果更佳

• 可在团队中推广 uv sync 保证依赖一致性