Ubuntu搭建Python虚拟环境：virtualenv

1 缘起

一阶段：Python开发，使用Windows环境，使用的相关依赖在Windows环境都能使用；
进入二阶段，开发了一个新功能，使用了k8s，Python依赖为：easy_k8s，
刚好，easy_k8s没有Windows版本，只能使用Linux环境，
当然，另一个状况是，公司收到Anaconda通知，没有商业授权，禁止在开发中使用Anaconda，
索性，不使用Anaconda，直接上virtualenv替代，
使用Ubuntu环境部署Python开发环境，过程记录如下，
帮助开发者快速搭建开发环境。

版本：
Ubuntu：20.04.6 LTS
Python：3.10
Pip：24.0

2 部署过程

2.1 环境准备

# 添加包仓库：Personal Package Archive
sudo add-apt-repository ppa:deadsnakes/ppa
# 更新仓库源
sudo apt update
# 安装python3.10
sudo apt install python3.10
# 安装Distutils
sudo apt install python3.10-distutils 
# 安装虚拟环境
sudo apt install virtualenv

Distutils是工具包，用于构建/安装Python环境中需要的包（可以是C/C++包、Python包），
安装过程中，没有安装distutils，使用pip安装依赖时出错。

2.2 应用

2.2.1 格式：新建虚拟环境

virtualenv /path

2.2.2 在.venv目录新建虚拟环境

指定python版本新建虚拟环境

virtualenv --python=/usr/bin/python3.10 .venv

2.2.3 升级pip版本：升级.venv虚拟环境pip

升级虚拟环境中pip的版本，保证后续的依赖安装可以正常进行，
遇到的问题：pip版本为20.x，安装依赖时，抛出异常，无法继续安装，
异常信息见Q&A部分。

curl -sS https://bootstrap.pypa.io/get-pip.py | .venv/bin/python3.10

2.2.4 安装依赖:在.venv虚拟环境中

在虚拟环境中安装依赖，
使用ALiYun源，这个源的包比较全，更新及时。

.venv/bin/pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple --trusted-host mirrors.aliyun.com

3 Q&A

3.1 问题1

RuntimeError: failed to query /usr/bin/python3.10 with code 1 err: ‘/usr/lib/python3/dist-packages/virtualenv/discovery/py_info.py:16: DeprecationWarning: The distutils package is deprecated and slated for removal in Python 3.12. Use setuptools or check PEP 632 for potential alternatives\n from distutils.command.install import SCHEME_KEYS\nTraceback (most recent call last):\n File “/usr/lib/python3/dist-packages/virtualenv/discovery/py_info.py”, line 16, in \n from distutils.command.install import SCHEME_KEYS\nModuleNotFoundError: No module named ‘distutils.command’\n’

3.1.1 原因

缺少distutils包。
distutils是辅助安装Python依赖的工具包，缺少distutils时，
会出现无法正常安装依赖问题，因为安装源码中使用到了distutils包，
源码如下：

from distutils.command.install import SCHEME_KEYS

因此，为了保证安装依赖正常进行，务必安装distutils工具包。

3.1.2 方案

安装distutils 包。

sudo apt install python3.10-distutils

3.2 问题2

Traceback (most recent call last):
File “/home/m/projects/p/.venv/bin/pip3”, line 8, in
sys.exit(main())
File “/home/m/projects/p/.venv/lib/python3.10/site-packages/pip/_internal/cli/main.py”, line 73, in main
command = create_command(cmd_name, isolated=(“–isolated” in cmd_args))
File “/home/m/projects/p/.venv/lib/python3.10/site-packages/pip/_internal/commands/init.py”, line 96, in create_command
module = importlib.import_module(module_path)
File “/usr/lib/python3.10/importlib/init.py”, line 126, in import_module
return _bootstrap._gcd_import(name[level:], package, level)
File “

3.2.1 原因

pip版本低，不满足需求。

3.2.2 方案

重新安装高版本pip。

curl -sS https://bootstrap.pypa.io/get-pip.py | {python路径}

在.venv虚拟环境中提升pip版本：

curl -sS https://bootstrap.pypa.io/get-pip.py | .venv/bin/python3.10

全局安装：

curl -sS https://bootstrap.pypa.io/get-pip.py | python3.10

4 总结

Ubuntu部署Python虚拟环境需要注意：
（1）添加个人源：deadsnakes
（2）安装distutils包；
（3）升级pip版本：推荐使用最新版24。