张芷铭的个人博客

uv 是 Astral 开发的极速 Python 包管理工具,替代 pip/venv/poetry,速度快 10-100 倍。

安装

1
2
3
4
5
6
7
8
# Linux/macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

# 验证
uv --version

核心指令

包操作(替代 pip)

指令功能
uv pip install <包名>安装包
uv pip install -r requirements.txt从文件安装
uv pip uninstall <包名>卸载包
uv pip list列出已安装包

虚拟环境

1
2
3
uv venv                # 创建 .venv
uv venv my_env         # 创建指定目录
source .venv/bin/activate  # 激活 (Linux/macOS)

项目依赖管理

1
2
3
4
5
uv init my_project     # 初始化项目
uv add requests        # 添加依赖
uv add --dev pytest    # 添加开发依赖
uv remove requests     # 移除依赖
uv lock                # 生成锁定文件

国内加速

1
UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple uv pip install <包名>

安装建议

  • 推荐:官方脚本或 pipx install uv
  • 不推荐pip install uv(易与项目依赖冲突)
1
2
pip install pipx && pipx ensurepath
pipx install uv

uv vs pip

特性uvpip
速度10-100x基准
虚拟环境内置需 venv
依赖锁定支持需 pip-tools
缓存高效基础

Comments