Ubuntu搭建Python虚拟环境:virtualenv

发布于:2024-04-24 ⋅ 阅读:(27) ⋅ 点赞:(0)

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。