Python3虚拟环境简介

创建: 2023-07-27 15:06
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，在虚拟环境中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.exec_prefix);print(sys.base_prefix);print(sys.prefix!=sys.base_prefix)"

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

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

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

/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.exec_prefix);print(sys.base_prefix);print(sys.prefix!=sys.base_prefix)"
/home/scz/src/Python3Venv
/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)