一、uv 是什么?
uv 是由 Astral 公司开发的 Rust 编写的 Python 工具链,核心优势是(比 pip 快 10-100 倍)、功能全面,集成了包安装、虚拟环境管理、依赖解析、项目构建等能力,兼容 pip/pipenv/poetry 的生态。
uv 是由 Astral 公司开发的 Rust 编写 Python 工具链,具备极速安装、虚拟环境管理及依赖解析能力。支持通用脚本安装及 Homebrew 等包管理器安装。核心功能涵盖基础包管理、虚拟环境创建、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