Skip to content

标题: Python3虚拟环境简介

创建: 2023-07-27 15:06 更新: 2023-07-28 20:11 链接: https://scz.617.cn/python/202307271506.txt

目录:

☆ 最简用法
    1) 判断当前Python环境是否为虚拟环境
    2) 并非必须用activate进入虚拟环境
☆ 从虚拟环境访问外部环境安装的模块
    1) 手工调整虚拟环境sys.path
    2) pyvenv.cfg
    3) 创建虚拟环境时使用特殊参数
☆ 虚拟环境技术原理
☆ 参考资源

☆ 最简用法

参[1]，以Linux中Python 3.10.6为例，不考虑Windows环境，后者有便携版方案，不 需要本文技术方案。低版本Python3不支持本文演示的某些参数，以相应版本官方文 档为准。

python3 -m venv /home/scz/src/Python3Venv

这将创建名为Python3Venv的子目录，有"mkdir -p"的效果，沿线目录不存在时自动 创建。

进入虚拟环境:

source /home/scz/src/Python3Venv/bin/activate

退出虚拟环境:

deactivate

删除虚拟环境:

rm -rf /home/scz/src/Python3Venv

在虚拟环境中pip安装模块，局限于其中，不影响外部环境。反过来，本小节创建的 虚拟环境看不到外部环境安装的模块，只有缺省模块(pip、setuptools)。

后续操作假设已在虚拟环境中

$ python3 -m pip list Package Version

pip 22.0.2 setuptools 59.6.0

升级这几个模块

python3 -m pip install --upgrade pip setuptools

$ pip3 list Package Version

pip 23.2.1 setuptools 68.0.0

这几个模块在虚拟环境中:

$ python3 -m pip show pip | grep Location Location: /home/scz/src/Python3Venv/lib/python3.10/site-packages

$ python3 -c "import pip;print(pip.file)" /home/scz/src/Python3Venv/lib/python3.10/site-packages/pip/init.py

$ python3 -c "import sys;print(sys.path)" ['', '/usr/lib/python310.zip', '/usr/lib/python3.10', '/usr/lib/python3.10/lib-dynload', '/home/scz/src/Python3Venv/lib/python3.10/site-packages']

注意，缺省情况下虚拟环境sys.path并不包含"/home/scz/.local/lib/..."。虚拟环 境的要点是sys.path，在虚拟环境中pip安装的模块位于:

/home/scz/src/Python3Venv/lib/python3.10/site-packages

Python3虚拟环境主要处理sys.path，对文件系统没有虚拟化，与chroot无关，不要 假设这是沙箱。

1) 判断当前Python环境是否为虚拟环境

activate之后，有个明显的前导提示符，表示位于虚拟环境中。此外，有个环境变量 被设置:

$ echo $VIRTUAL_ENV $ python3 -c "import os;print(os.getenv('VIRTUAL_ENV'))" /home/scz/src/Python3Venv

若想在some.py中判断是否为虚拟环境，用下列技术方案:

python3 -c "import sys;print(sys.prefix);print(sys.base_prefix);print(sys.exec_prefix);print(sys.base_exec_prefix);print(sys.prefix!=sys.base_prefix)"

假设在虚拟环境中，上述命令输出

/home/scz/src/Python3Venv /usr /home/scz/src/Python3Venv /usr True

假设在外部环境中，上述命令输出

/usr /usr /usr /usr False

显示True时在虚拟环境中，原理是虚拟环境的sys.prefix不同于sys.base_prefix。

2) 并非必须用activate进入虚拟环境

为进入虚拟环境，可以不用activate脚本，直接执行虚拟环境中的Python3解释器即 可。

$ /home/scz/src/Python3Venv/bin/python3 -c "import sys;print(sys.prefix);print(sys.base_prefix);print(sys.exec_prefix);print(sys.base_exec_prefix);print(sys.prefix!=sys.base_prefix)" /home/scz/src/Python3Venv /usr /home/scz/src/Python3Venv /usr True

此法不会设置VIRTUAL_ENV环境变量:

$ /home/scz/src/Python3Venv/bin/python3 -c "import os;print(os.getenv('VIRTUAL_ENV'))" None

故，若VIRTUAL_ENV有值，在虚拟环境中；若VIRTUAL_ENV无值，无法判断在何种环境 中。还是"sys.prefix!=sys.base_prefix"靠谱。

☆ 从虚拟环境访问外部环境安装的模块

有时出于各种原因，想从虚拟环境访问外部环境安装的模块，比如为了节省空间。这 是可行的，下面分述几种方案。

1) 手工调整虚拟环境sys.path

假设已按「最简用法」创建虚拟环境，缺省无法从虚拟环境访问外部环境安装的模块。 为达目的，手工调整虚拟环境sys.path即可。

后续操作假设已在虚拟环境中

python3 import sys sys.path.extend(['/home/scz/.local/lib/python3.10/site-packages', '/usr/local/lib/python3.10/dist-packages', '/usr/lib/python3/dist-packages']) print(sys.path) import hexdump print(hexdump.file)

顺利的话，最后一行代码输出:

/usr/local/lib/python3.10/dist-packages/hexdump.py

若未调整sys.path，导入hexdump模块失败。

2) pyvenv.cfg

vi /home/scz/src/Python3Venv/pyvenv.cfg

「最简用法」生成的该文件内容如下:

home = /usr/bin include-system-site-packages = false version = 3.10.6

将其中的false改成true(大小写不敏感):

home = /usr/bin

include-system-site-packages = false

include-system-site-packages = true version = 3.10.6

重新进入Python3解释器，sys.path已自动调整成:

['', '/usr/lib/python310.zip', '/usr/lib/python3.10', '/usr/lib/python3.10/lib-dynload', '/home/scz/src/Python3Venv/lib/python3.10/site-packages', '/home/scz/.local/lib/python3.10/site-packages', '/usr/local/lib/python3.10/dist-packages', '/usr/lib/python3/dist-packages']

编辑pyvenv.cfg与是否在activate状态无关。

3) 创建虚拟环境时使用特殊参数

python3 -m venv --system-site-packages --symlinks --upgrade-deps --prompt Virtual /home/scz/src/Python3Venv

--system-site-packages

让pyvenv.cfg中出现"include-system-site-packages = true"

--symlinks

虚拟化时尽可能使用符号链接，对于Linux这是缺省选择

--upgrade-deps

创建虚拟环境时自动升级pip、setuptools模块，这是3.9开始支持的参数

--prompt Virtual

就上例而言，若不指定该参数，进入虚拟环境后前导提示符是(Python3Venv)，
若指定该参数，进入虚拟环境后前导提示符是(Virtual)

☆ 虚拟环境技术原理

参[2]，好像从Python 3.3就开始支持虚拟环境。

引入虚拟环境技术之前，假设未设置PYTHONHOME环境变量，Python解释器启动时，会 从其所在目录开始搜索os.py，若找到，则据此设置sys.prefix，若未找到，使用编 译进ELF的内置值。

引入虚拟环境技术之后，在上述步骤之前增加了一步。Python解释器启动时，会在其 所在目录及父目录中(不跟随符号链接)寻找pyvenv.cfg，并在pyvenv.cfg中寻找home 行。若找到home行，则判定当前属于虚拟环境，sys.prefix设置成pyvenv.cfg所在目 录。

sys.prefix主要用于定位site-packages目录，pip安装的模块位于其中。假设虚拟环 境、外部环境同时有同名模块，在虚拟环境中import时，虚拟环境同名模块优先。

于是，虚拟环境主要涉及三部分，到原始解释器的符号链接，伴生pyvenv.cfg文件， 下级site-packages目录。

☆ 参考资源

[1] Creation of virtual environments https://docs.python.org/3/library/venv.html

Virtual Environments and Packages
https://docs.python.org/3/tutorial/venv.html

[2] PEP 405 - Python Virtual Environments - [2011-06-13] https://peps.python.org/pep-0405/