Python uv管理器常用命令介绍

uv 是一个极速 Python 包管理器，旨在作为 pip、virtualenv 和 pip-tools 的 现代替代品，具备极快的安装速度和良好的项目依赖管理能力。

---

✅ 一览：常用命令速查表

功能类别	命令	说明
创建环境	uv venv	创建虚拟环境（等价于 virtualenv）
安装依赖	uv pip install package	安装某个包
安装当前项目	uv pip install .	安装当前目录为项目（常用于开发）
安装开发依赖	uv pip install --dev	安装 [project.optional-dependencies.dev] 中的内容
卸载包	uv pip uninstall package	卸载某个依赖包
显示依赖树	uv pip list	显示当前虚拟环境所有依赖
锁定依赖	uv pip compile	类似 pip-tools，生成锁定的依赖列表
执行命令	uv run python main.py	在虚拟环境中运行命令（替代 source venv）
清理缓存	uv cache clear	清空 uv 的缓存
包升级	uv pip install --upgrade package	升级某个依赖包
查看缓存	uv cache info	查看缓存状态

---

🛠 命令详解 + 企业实战场景

1️⃣ 创建虚拟环境

uv venv

📌 说明：默认在当前目录创建 .venv 文件夹，企业项目推荐保存在 .venv/ 中便于隔离。

---

2️⃣ 安装依赖包（如 pandas）

uv pip install pandas

🎯 实战建议：内部数据处理工具常使用 pandas/numpy，可通过此命令快速集成。

---

3️⃣ 安装开发依赖（如 pytest, black 等）

uv pip install --dev

🔧 自动安装 pyproject.toml 中：

[project.optional-dependencies]
dev = ["black", "pytest", "mypy"]

---

4️⃣ 安装当前项目（开发模式）

uv pip install .

📦 安装当前目录为 Python 包，适用于：

• 库开发（如 company-logger）
• 提供 entry_points 的可执行工具

---

5️⃣ 升级依赖包

uv pip install --upgrade requests

💡 支持升级指定版本或全部依赖（配合 uv pip list 使用）

---

6️⃣ 查看当前环境的包信息

uv pip list

📊 显示类似 pip freeze 的所有依赖和版本，适合 Debug 与镜像构建分析。

---

7️⃣ 生成锁定文件（freeze）

uv pip compile

📌 类似 pip-tools，将当前依赖锁定到 requirements.txt 或 uv.lock 中。

🔐 适合用于：

• 企业内网镜像构建
• 锁定版本避免依赖漂移（dependency drift）

---

8️⃣ 在虚拟环境中运行代码

uv run python main.py

⚙️ 替代传统 source .venv/bin/activate，适用于自动化脚本、CI/CD 构建等场景。

---

9️⃣ 清除缓存（避免中毒依赖）

uv cache clear

🧹 遇到包安装异常、缓存冲突等建议执行。

---

✅ 项目推荐结构（实战建议）

my-project/
├── .venv/                  # uv venv 创建的环境
├── pyproject.toml          # 统一依赖与元数据
├── uv.lock                 # 锁定版本（可选）
├── src/
│   └── my_project/
├── tests/
└── README.md

---

🚀 UV vs pip 的优势总结

对比维度	uv	pip
安装速度	🚀 极快（Rust实现 + 并发）	⏳ 普通
虚拟环境集成	✅ 一体化	❌ 需配合 virtualenv
pyproject 支持	✅ 原生支持	⏳ 逐步支持中
多平台体验	✅ 良好	✅ 良好
企业推荐程度	✅ 高（适合新项目）	中（适合遗留项目）