uv 是一个用 Rust 写的极速 Python 包管理与项目工具,可作为 pipvenv 的替代,实现项目、依赖、Python 版本的一体化管理 。

⚙️ 安装与初始化

安装命令

  • macOS / Linuxcurl -LsSf https://astral.sh/uv/install.sh | sh
  • Windows:在 PowerShell 中执行 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

项目初始化

  • uv init 项目名:新建项目,生成 pyproject.toml 等文件 。
  • uv venv:在当前目录创建虚拟环境 (.venv) 。

📦 核心命令速查

uv 支持项目模式(推荐)和 pip 兼容模式,常用命令分类如下:

类别 命令 说明
项目管理 uv init 初始化新项目
uv add 包名 添加依赖
uv remove 包名 移除依赖
uv sync 按锁文件同步环境(项目模式核心)
uv lock 生成/更新 uv.lock 锁文件
uv run 脚本.py 在项目环境中运行脚本
pip 兼容 uv pip install 包名 安装包(传统方式)
uv pip install -r requirements.txt 从文件安装
uv pip freeze 导出包列表
Python 版本 uv python install 3.12 安装指定 Python
uv python pin 3.11 固定项目使用的 Python 版本
uv python list 列出可用/已安装版本
工具运行 uvx 工具名 临时运行工具(如 ruff),不污染环境

核心优势

  • 极速:依赖解析和安装比传统工具快数倍至数十倍 。
  • 项目即环境:在项目根目录运行命令,自动管理环境,无需手动激活 。
  • 全能:集成了 pipvenvpyenvpip-tools 的功能 。
Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐