0

0

Python 虚拟环境 venv 的工作原理解析

舞姬之光

舞姬之光

发布时间:2026-02-11 18:26:02

|

313人浏览过

|

来源于php中文网

原创

venv 通过修改 sys.executable、sys.prefix 和 PATH 环境变量,配合 pyvenv.cfg 配置文件实现解释器“换家当”,不复制二进制文件而隔离 site-packages;激活脚本仅设置环境变量,非必需但可避免误装包。

python 虚拟环境 venv 的工作原理解析

venv 是怎么让 Python 解释器“换一套家当”的

它不复制 Python 二进制文件,而是通过修改 sys.executablesys.prefix 和环境变量 PYTHONHOME(实际不设)来重定向模块查找路径。核心动作是生成一个独立的 pyvenv.cfg 文件,并在 bin/activate(或 Scripts/activate.bat)里临时篡改 PATH,把虚拟环境bin(或 Scripts)提到最前。

这意味着:同一台机器上多个 venv 可以共用系统 Python 的 C 库和解释器本体,但各自有隔离的 site-packages 和可执行脚本软链接(如 pippython)。你运行 python 时调用的仍是原解释器,只是它启动时读了新的配置。

  • 常见错误现象:which python 显示的是虚拟环境路径,但 python -c "import sys; print(sys.base_prefix)" 指向系统路径——这完全正常,sys.base_prefix 是原始解释器位置,sys.prefix 才是当前 venv 根目录
  • 使用场景:CI 构建、多项目依赖冲突、测试不同版本库兼容性;不适合替代系统包管理(如用 venv 装 systemdapt 工具)
  • 参数差异:python -m venv --system-site-packages myenv 会软链接系统 site-packages,但后续 pip install 仍写入 venv 自己的目录,容易引发隐式依赖混乱,慎用

激活(activate)不是必须的,但不激活就容易漏掉关键细节

激活脚本本质只是设置几个 shell 环境变量:PATHVIRTUAL_ENV,并重定义 deactivate 函数。你不运行它,也能直接调用 myenv/bin/pythonmyenv/bin/pip,但以下三点会出问题:

  • pip install 不加 --target 时,默认装进当前解释器的 site-packages —— 如果你没激活、又误用了系统 pip,包就装到系统里了
  • 某些工具(如 pylintblack)依赖 VIRTUAL_ENV 环境变量判断是否在隔离环境中,否则可能加载错配置或插件路径
  • Windows 下不激活直接跑 Scripts\python.exe 没问题,但 Scripts\pip.exe 在旧版 Python(如 3.8 以前)可能因硬编码路径失败,建议统一走 python -m pip

venv 和 conda、poetry、pipenv 的根本区别在哪

venv 只管 Python 解释器和包路径隔离,不碰编译器、系统库、非 Python 工具链。conda 是完整环境管理系统,能装 numpy 的 MKL 版本、ffmpeg、甚至 R 语言解释器;poetry/pipenv 则是在 venv 上叠加依赖解析与锁定逻辑,底层仍调用 venvvirtualenv 创建环境。

立即学习Python免费学习笔记(深入)”;

Slazzer
Slazzer

免费在线抠除图片背景

下载

所以当你看到 poetry env info --path 输出一个路径,进去看,里面就是个标准 venv 结构:有 pyvenv.cfgbin/lib/python3.x/site-packages/

  • 性能影响:纯 venv 创建极快(毫秒级),conda 创建环境常需几秒到几十秒,因为它要下载并解压二进制包
  • 兼容性风险:用 conda 创建的环境不能直接被 python -m venv 识别;反过来,venv 环境也不能用 conda install 管理
  • 容易踩的坑:在 poetry 项目里手动运行 python -m venv .venv,再 poetry install,会导致 poetry 使用自己创建的 venv 覆盖掉你那个,且不会提示

删除 venv 就是删文件夹,但要注意残留的编辑器/IDE 缓存

rm -rf myenv(macOS/Linux)或 rmdir /s myenv(Windows)就完事。没有注册表项、没有全局钩子、不改系统 Python 配置。但 VS Code、PyCharm 这类工具可能缓存了该环境的解释器路径和包索引,在删除后仍显示“已选中”,甚至尝试补全已删模块。

  • VS Code:打开命令面板(Ctrl+Shift+P),运行 Python: Select Interpreter,选 Enter interpreter path...,再手动指向新环境,旧路径会自动从下拉列表消失
  • PyCharm:进入 File → Settings → Project → Python Interpreter,点右上角齿轮 → Show All... → 选中旧环境 → 减号删除;注意勾选 Show hidden files and folders 才能看到已删但未清理的条目
  • 别忘了检查 .gitignore —— 如果你曾把 venv/ 提交过,删除后 git status 可能仍显示它,需 git rm -r --cached venv/ 清除索引

真正麻烦的从来不是创建或删除,而是搞不清哪个 python 正在被执行、哪个 pip 正在往哪装包。盯住 which pythonpython -c "import sys; print(sys.prefix)"pip list -v 这三行命令,比记所有原理都管用。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

346

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

422

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

783

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

356

2025.07.23

python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

191

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

11

2026.02.03

自建git服务器
自建git服务器

git服务器是目前流行的分布式版本控制系统之一,可以让多人协同开发同一个项目。本专题为大家提供自建git服务器相关的各种文章、以及下载和课程。

810

2023.07.05

git和svn的区别
git和svn的区别

git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。

572

2023.07.06

2026春节习俗大全
2026春节习俗大全

本专题整合了2026春节习俗大全,阅读专题下面的文章了解更多详细内容。

68

2026.02.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.1万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号