跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Python

Python 虚拟环境管理工具 UV:从安装到高级用法详解

UV 是一款高性能的 Python 包管理和虚拟环境工具,旨在解决依赖冲突与环境隔离问题。涵盖 UV 的安装配置、虚拟环境创建与激活、多版本 Python 管理以及依赖包操作指南。通过对比传统方案,展示 UV 在跨平台开发中的效率优势,并提供常见问题解答,帮助开发者快速上手并优化工作流。

活在当下发布于 2026/3/27更新于 2026/10/2589 浏览

Python 虚拟环境管理工具 UV:从安装到高级用法详解

在 Python 开发中,不同项目往往依赖不同版本的库,甚至同一库在不同版本下行为迥异。为了避免这种依赖冲突,使用虚拟环境隔离每个项目的依赖成了标准做法。除了传统的 virtualenv 和 venv,UV 作为一个新兴的轻量级工具,提供了更高效的命令行体验。

什么是 UV?

UV 是一个用 Rust 编写的高性能 Python 包管理和虚拟环境工具。相比传统方案,它的优势在于速度极快且命令简洁直观,无需复杂配置即可高效管理 Python 环境。它支持多版本管理、跨平台运行(Windows、Linux、macOS),非常适合现代开发场景。

安装 UV

环境要求

确保系统已安装 Python。可通过以下命令检查:

python --version

若未安装,请前往 Python 官网 下载。

安装步骤

使用 pip 即可快速安装:

pip install uv

安装完成后验证版本:

uv --version

基本使用

创建虚拟环境

这是 UV 的核心功能之一。创建一个名为 myenv 的环境:

uv venv myenv

UV 会自动选择系统默认的 Python 版本并建立隔离环境。你可以在其中安装包,而不会影响全局环境。

激活虚拟环境

创建后需要激活才能使用。在 Linux/macOS 上:

source .venv/bin/activate

Windows 上则运行:

.\myenv\Scripts\activate

激活后,命令行提示符通常会显示环境名称,表明当前处于隔离状态。

查看当前环境

随时检查当前激活的环境信息:

uv venv

该命令会显示当前环境的详细信息及路径。

管理 Python 版本

指定版本创建

如果需要特定版本的 Python,可以使用 --python 参数:

uv venv myenv --python=3.8

UV 会自动处理版本匹配,确保环境基于指定的 Python 构建。

切换 Python 版本

如果已有环境需要升级或降级 Python 版本,可以重新指定:

uv venv myenv --python=3.9

或者使用 uv python 命令管理已安装的版本列表:

uv python list

查看可用版本

列出系统中所有可用的 Python 版本供选择:

uv python list

管理依赖包

安装包

激活环境后,直接使用 uv pip 安装依赖,速度通常优于标准 pip:

uv pip install requests

确认安装情况:

uv pip list

导出依赖

将当前环境的所有依赖导出为 requirements.txt,方便协作:

uv pip freeze > requirements.txt

其他开发者可直接使用此文件还原环境:

uv pip install -r requirements.txt

卸载包

不再需要的包可以直接移除:

uv pip uninstall requests

虚拟环境管理

切换环境

直接激活另一个已存在的环境:

uv venv anotherenv

查看所有环境

列出当前目录下所有创建的虚拟环境:

uv venv

删除环境

不再需要时,直接删除目录即可清除环境:

rm -rf myenv

注意:删除操作不可恢复,请谨慎操作。

常见问题解答 (FAQ)

如何退出虚拟环境?

使用标准的 deactivate 命令返回全局环境:

deactivate

UV 与 venv/virtualenv 有何不同?

  • UV:基于 Rust 开发,速度更快,集成了包管理和环境管理,适合追求效率的团队。
  • venv:Python 标准库自带,功能基础但稳定,适合简单项目。
  • virtualenv:功能丰富,支持更多高级特性,适合对兼容性有严格要求的场景。

结语

通过上述介绍,你应该已经掌握了使用 UV 管理 Python 虚拟环境的基本流程。无论是单个项目还是多项目并行,UV 都能帮助你有效隔离环境,避免依赖冲突。其简洁的命令和卓越的性能,使其成为现代 Python 开发中的得力助手。

目录

  1. Python 虚拟环境管理工具 UV:从安装到高级用法详解
  2. 什么是 UV?
  3. 安装 UV
  4. 环境要求
  5. 安装步骤
  6. 基本使用
  7. 创建虚拟环境
  8. 激活虚拟环境
  9. 查看当前环境
  10. 管理 Python 版本
  11. 指定版本创建
  12. 切换 Python 版本
  13. 查看可用版本
  14. 管理依赖包
  15. 安装包
  16. 导出依赖
  17. 卸载包
  18. 虚拟环境管理
  19. 切换环境
  20. 查看所有环境
  21. 删除环境
  22. 常见问题解答 (FAQ)
  23. 如何退出虚拟环境?
  24. UV 与 venv/virtualenv 有何不同?
  25. 结语

更多推荐文章

查看全部
  • Stable Diffusion 3.5 提示词语法校验与错误拦截部署指南
  • Spring Boot 自定义错误页面:404/500 页面定制与 ErrorController
  • AI 大模型学习的五大关键研究方向
  • Android UI 性能优化:TraceView 工具简介与使用
  • 前端常见渲染方式对比与实现详解
  • Ubuntu 下 Python 连接 KingbaseES 数据库实现增删改查
  • 自动化验证码识别系统构建:图像处理与 OCR 实战
  • 大模型技术:检索增强生成 RAG 详解
  • OpenClaw 开源框架解析:本地 Agent 部署与硬件生态影响
  • 前端工程师转型 AI Agent 开发工程师完整学习路线
  • 解决 VSCode Copilot 聊天加载超时
  • Python 全流程图文安装教程
  • Stable Diffusion WebUI 落幕:ComfyUI 崛起背后的技术演进
  • 二分查找与双指针算法实战:LeetCode 704、35、34、27、977
  • Python 结合 Stable Diffusion 生成企业新春营销素材实战
  • 人工智能多模态模型开发与应用:文本、图像与语音融合实践
  • 飞书机器人与 Claude Code 交互:从手机指令到 AI 处理的全自动流程
  • LLaMA-Factory:大语言模型预训练、微调、评估与部署实战指南
  • 大模型在日常生活中的五大应用场景与使用建议
  • 大模型高效推理与部署技术实战

相关免费在线工具

  • 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