跳到主要内容
极客日志极客日志
首页博客AI提示词GitHub精选代理工具
搜索
|注册
博客列表

目录

  1. 一、uv 是什么?
  2. 二、uv 的安装
  3. 1. 通用安装方式(推荐)
  4. macOS/Linux
  5. Windows (PowerShell)
  6. 2. 包管理器安装(可选)
  7. 3. 验证安装
  8. 输出示例:uv 0.1.37 (a1b2c3d 2026-03-03)
  9. 三、uv 核心使用场景
  10. 1. 基础包安装/卸载
  11. 2. 虚拟环境管理
  12. 创建虚拟环境(默认在 .venv 目录)
  13. 激活虚拟环境
  14. macOS/Linux
  15. Windows (Cmd)
  16. Windows (PowerShell)
  17. 删除虚拟环境
  18. 3. 项目依赖管理(兼容 pyproject.toml)
  19. 初始化项目(生成 pyproject.toml)
  20. 添加依赖(自动写入 pyproject.toml)
  21. 生产依赖
  22. 开发依赖
  23. 安装项目所有依赖(从 pyproject.toml)
  24. 同步依赖(移除未在 pyproject.toml 中声明的包)
  25. 4. 运行 Python 代码/脚本
  26. 运行脚本
  27. 运行临时代码
  28. 运行模块
  29. 四、进阶用法
  30. 总结
  • 💰 8折买阿里云服务器限时8折了解详情
Python

Python 开发工具 uv 安装、配置与最佳实践

uv 是由 Astral 公司开发的 Rust 编写 Python 工具链,具备极速安装、虚拟环境管理及依赖解析能力。支持通用脚本安装及 Homebrew 等包管理器安装。核心功能涵盖基础包管理、虚拟环境创建、pyproject.toml 依赖管理及代码运行。进阶支持缓存清理、指定 Python 版本执行及 pip 加速。建议新项目采用 uv init 配合 pyproject.toml 规范依赖管理。

zhang发布于 2026/3/30更新于 2026/4/211 浏览
Python 开发工具 uv 安装、配置与最佳实践

一、uv 是什么?

uv 是由 Astral 公司开发的 Rust 编写的 Python 工具链,核心优势是(比 pip 快 10-100 倍)、功能全面,集成了包安装、虚拟环境管理、依赖解析、项目构建等能力,兼容 pip/pipenv/poetry 的生态。

极速
  1. uv 官方文档(最核心) 地址:https://docs.astral.sh/uv/ 这是 uv 最权威的使用指南,包含安装、基础用法、进阶功能、API 参考等所有内容,也是排查问题的首选。
  2. uv GitHub 源码仓库 地址:https://github.com/astral-sh/uv 可以查看源码、提交 Issue(反馈问题)、提 PR(贡献代码),也能在 Releases 页面下载指定版本的 uv 安装包,查看更新日志。
  3. uv 快速入门教程 地址:https://docs.astral.sh/uv/getting-started/ 官方专为新手设计的快速上手指南,比完整文档更精简,适合刚接触 uv 时快速掌握核心用法。

二、uv 的安装

1. 通用安装方式(推荐)

适用于 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"

2. 包管理器安装(可选)

pip 安装(不推荐,仅应急):

pip install uv

Cargo (Rust 环境):

cargo install uv --locked

Homebrew (macOS/Linux):

brew install uv

3. 验证安装

安装完成后,重启终端,执行以下命令验证:

uv --version
# 输出示例:uv 0.1.37 (a1b2c3d 2026-03-03)

三、uv 核心使用场景

1. 基础包安装/卸载

uv 兼容 pip 的大部分用法,且默认使用虚拟环境(无需手动激活),核心命令如下:

功能uv 命令说明
安装包uv pip install requests极速安装单个包
安装指定版本uv pip install requests==2.31.0安装特定版本
从 requirements.txtuv pip install -r requirements.txt批量安装依赖,速度远快于 pip
升级包uv pip install --upgrade requests升级包到最新版本
卸载包uv pip uninstall requests卸载包
查看已安装包uv pip list列出当前环境的包
导出依赖uv pip freeze > requirements.txt导出已安装包到文件

2. 虚拟环境管理

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

3. 项目依赖管理(兼容 pyproject.toml)

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

4. 运行 Python 代码/脚本

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,但更快

总结

  1. uv 是高性能的 Python 包/环境管理工具,安装简单,兼容 pip/venv 生态,核心优势是速度快、功能集成度高。
  2. 核心用法:uv pip install(安装包)、uv venv(虚拟环境)、uv add(管理项目依赖)、uv run(运行代码)。
  3. 推荐在新项目中使用 uv init + pyproject.toml 替代传统的 requirements.txt,提升依赖管理规范性。
  • 💰 8折买阿里云服务器限时8折购买
  • 🦞 5分钟部署阿里云小龙虾了解详情
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog

更多推荐文章

查看全部
  • ClawX:可视化 AI 智能体工具使用指南
  • Neo4j 图数据库核心知识与在线控制台使用指南
  • 机器人领域顶级国际会议推荐:IROS 与 ICRA
  • Stable Diffusion 与 ComfyUI 整合包安装配置及常见问题解决
  • AI Agent 架构:基础组成模块深度解析
  • 5 款免费 AI 视频生成工具推荐
  • Vheer:免费免登录 AI 绘画视频生成与智能编辑工具
  • SpringBoot 整合 LangChain4j 实现 RAG 检索实战
  • 数据结构:顺序表概念与实现
  • Java 部署:Jenkins Pipeline 自动化构建 Java 项目
  • Windows 本地部署 Ollama 与 OpenClaw 构建 AI 工作流
  • 本地 AI 小说自动生成工具部署与使用指南
  • npm 安装 OpenClaw 时 Git 报错的解决方法
  • OpenClaw 多飞书机器人与多 Agent 团队实战复盘
  • 基于 Coze 构建专属 AI 应用:从智能体到 Web 部署
  • 基于三省六部制的 AI Agent 协作架构 Edict 框架
  • 深度学习反向传播原理:链式法则与责任分配
  • 鸿蒙金融理财全栈项目:上线运维、用户反馈与持续迭代
  • 边缘计算设备部署轻量 TensorFlow 模型全流程
  • C++ 智能指针详解:从裸指针到 unique_ptr、shared_ptr、weak_ptr

相关免费在线工具

  • curl 转代码

    解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online