一、uv 是什么?
uv 是由 Astral 公司开发的 Rust 编写的 Python 工具链,核心优势是(比 pip 快 10-100 倍)、功能全面,集成了包安装、虚拟环境管理、依赖解析、项目构建等能力,兼容 pip/pipenv/poetry 的生态。
uv 是由 Astral 公司开发的 Rust 编写的 Python 工具链,具备极速安装、虚拟环境管理及依赖解析能力,兼容 pip/poetry 生态。 uv 的通用及包管理器安装方式,验证步骤,以及基础包管理、虚拟环境创建、项目依赖配置(pyproject.toml)和脚本运行等核心场景。此外还涵盖了缓存清理、指定 Python 版本及加速 pip 等进阶用法,推荐在新项目中采用 uv init 配合 pyproject.toml 进行规范化依赖管理。

uv 是由 Astral 公司开发的 Rust 编写的 Python 工具链,核心优势是(比 pip 快 10-100 倍)、功能全面,集成了包安装、虚拟环境管理、依赖解析、项目构建等能力,兼容 pip/pipenv/poetry 的生态。
uv 最权威的使用指南,包含安装、基础用法、进阶功能、API 参考等所有内容,也是排查问题的首选。uv 安装包,查看更新日志。uv 时快速掌握核心用法。适用于 macOS、Linux、Windows(PowerShell),执行以下命令自动下载适配系统的版本:
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
pip 安装(不推荐,仅应急):
pip install uv
Cargo (Rust 环境):
cargo install uv --locked
Homebrew (macOS/Linux):
brew install uv
安装完成后,重启终端,执行以下命令验证:
uv --version
# 输出示例:uv 0.1.37 (a1b2c3d 2026-03-03)
uv 兼容 pip 的大部分用法,且默认使用虚拟环境(无需手动激活),核心命令如下:
| 功能 | uv 命令 | 说明 |
|---|---|---|
| 安装包 | uv pip install requests | 极速安装单个包 |
| 安装指定版本 | uv pip install requests==2.31.0 | 安装特定版本 |
| 从 requirements.txt | uv pip install -r requirements.txt | 批量安装依赖,速度远快于 pip |
| 升级包 | uv pip install --upgrade requests | 升级包到最新版本 |
| 卸载包 | uv pip uninstall requests | 卸载包 |
| 查看已安装包 | uv pip list | 列出当前环境的包 |
| 导出依赖 | uv pip freeze > requirements.txt | 导出已安装包到文件 |
uv 内置虚拟环境功能,比 venv 更简洁:
# 创建虚拟环境(默认在 .venv 目录)
uv venv
# 激活虚拟环境
# macOS/Linux
source .venv/bin/activate
# Windows (Cmd)
.venv\Scripts\activate.bat
# Windows (PowerShell)
.venv\Scripts\Activate.ps1
# 删除虚拟环境
rm -rf .venv # macOS/Linux
rmdir /s .venv # Windows
uv 支持现代 Python 项目的 pyproject.toml 配置,替代 requirements.txt:
# 初始化项目(生成 pyproject.toml)
uv init my_project
cd my_project
# 添加依赖(自动写入 pyproject.toml)
uv add requests # 生产依赖
uv add --dev pytest # 开发依赖
# 安装项目所有依赖(从 pyproject.toml)
uv install
# 同步依赖(移除未在 pyproject.toml 中声明的包)
uv sync
uv 可直接运行代码,自动使用当前虚拟环境:
# 运行脚本
uv run script.py
# 运行临时代码
uv run -c "print('Hello, uv!')"
# 运行模块
uv run -m http.server 8000
缓存管理:uv 有全局缓存,清理缓存命令:
uv cache clean # 清理所有缓存
指定 Python 版本:uv 可自动下载指定版本的 Python(需提前安装 pyenv 或 uv 内置的 Python 解析器):
uv python install 3.11 # 安装 Python 3.11
uv run --python 3.11 script.py # 使用 3.11 运行脚本
加速 pip 兼容:如果项目暂时不想切换到 uv 命令,可通过 uv 加速 pip:
uv pip install requests # 等同于 pip install,但更快
uv 是高性能的 Python 包/环境管理工具,安装简单,兼容 pip/venv 生态,核心优势是速度快、功能集成度高。uv pip install(安装包)、uv venv(虚拟环境)、uv add(管理项目依赖)、uv run(运行代码)。uv init + pyproject.toml 替代传统的 requirements.txt,提升依赖管理规范性。
微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online