Python 3.6/3.7虚拟环境创建卡在ensurepip？一份针对老版本Python的venv避坑指南

Python 3.6/3.7虚拟环境创建卡在ensurepip？一份针对老版本Python的venv避坑指南

在企业级开发环境中，我们常常会遇到需要维护历史遗留项目的情况。这些项目可能因为依赖关系或兼容性问题，不得不运行在Python 3.6或3.7等较旧版本上。最近在为某金融系统升级时，我发现团队成员在创建虚拟环境时频繁遭遇exit status 1错误，这促使我深入研究了老版本Python虚拟环境创建的种种陷阱。

1. 问题根源：为什么老版本Python更容易出现venv创建失败

当你在Python 3.6或3.7上执行python -m venv myenv时，背后其实发生了一系列复杂的操作。系统首先会创建环境目录结构，然后尝试通过ensurepip模块安装pip。这个过程在老版本Python中特别容易出问题，主要原因有三：

1. 模块完整性差异：Python 3.6时期的打包策略与现在不同，某些发行版（特别是企业定制版或教育版）可能会精简掉ensurepip模块以减小体积。我曾在某银行的开发机上发现，他们定制的Python 3.6.5完全移除了这个"非必要"模块。

2. 网络访问限制：即使ensurepip存在，它默认会从PyPI官方源下载最新pip版本。在企业内网或受控环境中，这种外网访问常常被防火墙阻断。更糟的是，老版本Python的SSL证书验证也可能因系统根证书过期而失败。

3. 版本兼容性陷阱：ensurepip在不同Python小版本中的行为有微妙差异。例如：

   Python版本	ensurepip行为特点
   3.6.0-3.6.4	强制尝试安装pip，失败即报错
   3.6.5+	开始支持--without-pip参数
   3.7.0-3.7.3	对网络超时更敏感
   3.7.4+	改进了重试机制

提示：如果你看到Error: Command returned non-zero exit status 1，首先检查错误信息中是否包含ensurepip关键词，这能快速定位问题类型。

2. 基础解决方案：快速让venv跑起来

对于急需使用虚拟环境的场景，以下是经过实战验证的快速解决方案：

2.1 跳过pip安装

最简单的规避方法是使用--without-pip参数。这个选项从Python 3.6.5开始提供，能完全绕过ensurepip步骤：

# 删除可能存在的失败环境 rm -rf myenv # 创建不包含pip的环境 python -m venv --without-pip myenv

创建完成后，你需要手动安装pip。这里有个技巧：先激活环境，然后用Python内置的urllib下载get-pip.py：

# Windows myenv\Scripts\activate python -c "import urllib.request; urllib.request.urlretrieve('https://bootstrap.pypa.io/get-pip.py', 'get-pip.py')" # Linux/macOS source myenv/bin/activate python -c "import urllib.request; urllib.request.urlretrieve('https://bootstrap.pypa.io/get-pip.py', 'get-pip.py')"

2.2 手动安装正确版本的pip

老版本Python对pip版本有严格要求。使用不兼容的pip版本会导致更隐蔽的问题。以下是各版本对应关系：

• Python 3.6：需要使用pip 18.1或更低版本
• Python 3.7：兼容pip 20.3之前的版本

手动安装特定版本pip的正确姿势：

# 下载对应版本的get-pip.py curl -O https://bootstrap.pypa.io/pip/3.6/get-pip.py # 安装指定版本 python get-pip.py "pip==18.1"

3. 高级技巧：离线环境下的venv配置

在金融、军工等隔离网络中，我们需要更完善的离线方案。以下是我在某证券公司实施的全套解决方案：

3.1 创建离线pip包缓存

首先在有网环境准备依赖包：

# 创建缓存目录 mkdir pip_cache # 下载pip及其依赖 python -m pip download -d pip_cache pip setuptools wheel # 打包缓存 tar czf pip_cache.tar.gz pip_cache

将压缩包拷贝到离线机器后，配置venv使用本地缓存：

python -m venv --without-pip myenv source myenv/bin/activate # 从缓存安装pip python -m pip install --no-index --find-links=./pip_cache pip

3.2 定制企业内部的venv脚本

对于需要频繁创建虚拟环境的团队，可以定制一个增强版venv脚本：

# save as myvenv.py import venv import os import sys class MyEnvBuilder(venv.EnvBuilder): def post_setup(self, context): if not self.with_pip: return # 自定义pip安装源 os.environ['PIP_INDEX_URL'] = 'http://internal-pypi.example.com/simple' super().post_setup(context) def main(): builder = MyEnvBuilder(with_pip='--without-pip' not in sys.argv) builder.create(sys.argv[-1]) if __name__ == '__main__': main()

使用方式：

# 创建标准环境 python myvenv.py myenv # 创建无pip环境 python myvenv.py --without-pip myenv

4. 疑难排查：当常规方法都失效时

在某些极端情况下，即使上述方法也可能失败。这时需要更深入的排查：

1. 检查Python安装完整性：

   # 验证ensurepip是否存在 python -c "import ensurepip; print(ensurepip.__file__)" # 检查模块是否可加载 python -m ensurepip --dry-run

2. 诊断网络问题：

   # 测试PyPI可达性 python -c "import urllib.request; urllib.request.urlopen('https://pypi.org', timeout=5)" # 检查SSL证书 openssl s_client -connect pypi.org:443

3. 替代方案：使用virtualenv：

   当venv完全不可用时，可以考虑安装更兼容的virtualenv工具：

   # 安装特定版本的virtualenv python -m pip install "virtualenv<20.0" # 创建环境 virtualenv --python=python3.6 myenv

在最近一次为制造业客户升级Python 3.6.8环境时，我们发现其Windows系统缺少VC++ 2015运行时库，导致ensurepip无法执行。通过安装对应的运行时组件后问题得以解决。这提醒我们，在老旧系统上，环境依赖问题往往比代码本身更棘手。