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

uv 虚拟环境管理:创建、激活与 Python 版本指定

uv 是 Rust 编写的极速 Python 包管理器,替代传统 venv 提升效率。 uv 安装方法,涵盖 Linux、macOS 及 Windows 平台。重点讲解如何快速创建虚拟环境、指定特定 Python 版本(含自动下载),以及不同 Shell 下的激活命令。包含版本管理高级技巧、配置文件设置、常见问题排查及 IDE 集成方案,帮助开发者解决多项目依赖冲突与环境一致性问题。

利刃发布于 2026/3/30更新于 2026/10/2483 浏览

uv 虚拟环境管理:创建、激活与 Python 版本指定

在 Python 开发中,虚拟环境是隔离项目依赖的关键工具。传统的 venv 或 virtualenv 往往存在创建慢、版本管理繁琐的问题。作为用 Rust 编写的极速包管理器,uv 提供了更高效的解决方案。

为什么选择 uv

相比传统工具,uv 的优势在于速度极快且内置了 Python 版本管理功能,能自动下载缺失的解释器。它还能无缝集成包管理,无需单独配置 pip。

特性uvvenvvirtualenv
创建速度极快(Rust 实现)较慢中等
Python 版本管理内置支持,可自动下载需要手动指定有限支持
跨平台兼容性优秀良好良好
缓存机制有无无
与包管理集成无缝集成需单独使用 pip需单独使用 pip

安装 uv

开始前先确保安装了 uv。不同系统安装方式如下:

Linux 和 macOS

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

验证安装:

uv --version

创建虚拟环境

基本用法

直接运行以下命令,会在当前目录生成 .venv 目录:

uv venv
指定名称或路径

默认是 .venv,也可以自定义:

uv venv myenv
# 或在指定路径创建
uv venv ../path/to/env
指定 Python 版本

uv 允许在创建时指定版本,若本地没有会自动下载:

uv venv --python 3.11
uv venv --python 3.12.3
uv venv --python ">=3.10,<3.13"

支持的格式包括具体版本号、范围、实现类型(如 cpython, pypy)等。

激活虚拟环境

激活后,终端的 Python 和 pip 将指向虚拟环境。

Linux/macOS Bash/Zsh:

source .venv/bin/activate

Fish:

source .venv/bin/activate.fish

Csh/Tcsh:

source .venv/bin/activate.csh

Windows CMD:

.venv\Scripts\activate.bat

PowerShell:

.venv\Scripts\Activate.ps1

激活成功通常能看到提示符前出现 (.venv)。

停用虚拟环境

退出时使用:

deprecate

Wait, command is deactivate. Typo in thought process.

deprecate

-> deactivate

Python 版本管理进阶

查看可用版本:

uv python list

安装特定版本:

uv python install 3.11.6

升级已安装的版本(预览特性):

uv python upgrade 3.12

配置偏好(优先使用系统还是 uv 管理的 Python):

uv config set python-preference system

自动发现与运行

即使不激活,也可以用 uv run 在环境中执行脚本:

uv run python script.py
uv run pip list

指定项目目录搜索:

uv --project /path/to/project run python script.py

配置与缓存

通过 uv.toml 自定义行为,例如默认版本和缓存策略。缓存管理命令:

uv cache dir
uv cache clean

常见问题

创建失败:检查版本是否有效,尝试 --allow-downloads。 激活问题:确认 shell 类型匹配激活脚本,或手动添加 bin 到 PATH。 IDE 兼容:确保 IDE 指向 .venv/bin/python 路径。

总结

uv 极大简化了虚拟环境管理流程。掌握 uv venv、版本指定及 uv run 命令,能有效提升多项目开发的效率与环境一致性。

目录

  1. uv 虚拟环境管理:创建、激活与 Python 版本指定
  2. 为什么选择 uv
  3. 安装 uv
  4. 创建虚拟环境
  5. 基本用法
  6. 指定名称或路径
  7. 或在指定路径创建
  8. 指定 Python 版本
  9. 激活虚拟环境
  10. 停用虚拟环境
  11. Python 版本管理进阶
  12. 自动发现与运行
  13. 配置与缓存
  14. 常见问题
  15. 总结

更多推荐文章

查看全部
  • 人工智能发展历程与现状分析
  • OpenClaw 安装及飞书机器人配置流程指南
  • DeepSeek-OCR-WEBUI 本地部署与 OCR 自动化集成
  • IDEA 集成通义千问插件的 Java 开发实战
  • Ollama 本地大模型部署与 WebAPI 调用实战指南
  • Text2SQL 跨数据库 SQL 转换实战代码
  • BeyondMimic 人形机器人运动模仿与 rl_sar 部署实践
  • Windows家用电脑也能玩转Gemma3大模型?手把手教你用Ollama+Open WebUI搭建AI聊天室
  • Ollama下载模型太慢?试试国内HuggingFace镜像+LLama-Factory组合
  • whisper.cpp 模型部署与性能实测:从 tiny 到 large-v3-turbo
  • NASA 火星任务软件测试:AIGC 模拟外星环境攻击
  • VS Code 安装 GitHub Copilot 及 AI 编程使用指南
  • LLaMA 大模型本地化稳定部署指南:基于 Ollama 与 NextChat
  • C++ string 模拟实现与底层细节深度解析
  • OpenWebUI联网搜索实战:如何用SearXNG让本地大模型获取实时信息(附百度/360配置)
  • [特殊字符] 终极解决方案:彻底攻克llama.cpp动态链接库加载失败难题
  • Midjourney sref编码进阶玩法:2026 AI图像风格统一秘籍
  • MC.JS WEBMC1.8 零基础入门:10 分钟创建方块世界
  • 使用 Trae IDE 结合 Figma MCP 将设计稿转化为前端代码
  • Claude Code 与 GitHub Copilot CLI 终端效率深度评测

相关免费在线工具

  • 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