【uv包管理工具】常用命令记录

uv 常用命令详解

uv 是新一代的 Python 包管理工具，结合了 pip 和 pipenv 的高效特性。以下是核心命令及其用途：

1. 环境初始化

uv init

在当前目录初始化项目环境，生成 pyproject.toml 文件（类似 pipenv 的 Pipfile）。

2. Python 版本管理

uv python pin 3.12

将当前项目的 Python 版本锁定为 3.12（写入 pyproject.toml）。

uv python find 3.10

查找本地是否已安装 Python 3.10，若未安装则自动下载。

uv python list --only-installed

仅列出当前系统中已安装的 Python 版本（隐藏可下载版本）。

3. 依赖管理

uv sync

根据 pyproject.toml 同步依赖（安装/更新/移除包），类似 pipenv sync。

4.使用 uv 创建和激活虚拟环境

uv venv .venv

使用 uv 创建虚拟环境非常快捷
这会在当前目录下创建一个名为 .venv 的虚拟环境文件夹。您可以根据需要自定义名称，例如 uv venv myenv。

source .venv/bin/activate

激活活虚拟环境
创建完成后，需要激活虚拟环境以使用其隔离的 Python 环境
激活后，终端提示符通常会显示虚拟环境名称（如 (.venv)），表示已成功激活

5. 补充常用命令

uv pip install numpy

直接安装包（兼容 pip 语法，速度更快）。

uv cache clean

清理包缓存以释放磁盘空间。

💡 优势对比

• ⚡ 速度：比 pip/pipenv 快 10–100 倍。
• 📦 兼容性：支持 requirements.txt 和 pyproject.toml。
• 🔒 可靠性：依赖解析基于 uv 自研的高效引擎。