一、最简用法
参[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)
————————————————————————–
参考资源
[1] Creation of virtual environments https://docs.python.org/3/library/venv.html
[2] Virtual Environments and Package https://docs.python.org/3/tutorial/venv.html