Windows10下Python虚拟环境pip安装包遇SSL模块缺失问题求助

1. 确认虚拟环境关联的Python版本 #

先明确你的虚拟环境使用的是哪个Python解释器：

• 激活虚拟环境，执行以下命令：

  python --version
  pip --version
  

查看输出的Python版本和路径，确认是C:\Python38还是C:\OSGeo4W64\apps\Python37——OSGeo4W自带的Python是为QGIS定制的，大概率缺失完整的SSL组件，优先选择官方Python38。

2. 修复基础Python的SSL模块 #

如果虚拟环境依赖的是官方Python38：

• 退出虚拟环境，直接运行C:\Python38\python.exe，输入import ssl，若报错则说明该Python安装本身存在问题：
  • 卸载当前Python38，前往官网下载完整的Windows Installer安装包（不要选择Embeddable Package）。
  • 重新安装时，务必勾选Add Python to PATH，进入自定义安装界面后，确保所有组件（包括pip、SSL相关组件）均被勾选。
  • 安装完成后再次运行import ssl测试，确认无报错。

如果虚拟环境依赖的是OSGeo4W的Python37：

• 不建议用该版本搭建开发虚拟环境，直接切换到官方Python38创建新环境。

3. 重建虚拟环境 #

基础Python修复完成后，重新创建干净的虚拟环境：

• 调整系统环境变量，将C:\Python38和C:\Python38\Scripts移至PATH最顶部，避免与OSGeo4W的Python版本冲突，随后重启命令行。
• 执行以下命令创建并激活新环境：

  python -m venv my_new_env
  my_new_env\Scripts\activate
  

• 先升级pip，验证问题是否解决：

  pip install --upgrade pip
  

4. 排查系统SSL依赖 #

若仍出现警告，检查Python的DLL路径是否在系统PATH中：

• 找到Python38安装目录下的DLLs文件夹（例如C:\Python38\DLLs），将该路径添加到系统环境变量的PATH中，重启命令行后再次测试。

内容的提问来源于stack exchange，提问作者Maryla