一、问题背景
在Windows 10系统中使用Python的包管理工具pip时，常常遇到类似如下的报错：
WARNING: pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.
Could not fetch URL https://mirrors.aliyun.com/pypi/simple/pip/: There was a problem confirming the ssl certificate: HTTPSConnectionPool(host='mirrors.aliyun.com', port=443): Max retries exceeded with url: /pypi/simple/pip/ (Caused by SSLError("Can't connect to HTTPS URL because the SSL module is not available.")) - skipping这类错误导致无法通过pip安装或更新Python包，尤其是在非Anaconda自带的命令行窗口（例如普通cmd）下执行pip时尤为明显。本文将从根源分析此问题的成因，并给出Windows系统下的针对性解决方案，确保pip的正常运行。
二、问题分析
1. SSL模块缺失的本质
Python的ssl模块依赖底层操作系统的OpenSSL库支持，负责支持Python通过HTTPS协议进行安全通信。该模块不可用，通常是因为Python解释器运行时无法正确加载SSL相关的动态链接库（DLL），导致pip无法建立HTTPS连接。
2. Anaconda环境特点
Anaconda集成了Python环境及大量科学计算库，并且默认配置了自己的环境路径。它包含一套完整的Library\bin目录，存放着OpenSSL所需的DLL文件（例如libcrypto-1_1-x64.dll和libssl-1_1-x64.dll）。如果环境变量配置不完整，普通cmd无法找到这些动态库，自然就会导致ssl模块不可用。
三、问题表现
- 通过Anaconda Prompt 执行
pip命令正常。 - 通过Windows系统普通CMD 或PowerShell执行
pip命令时报错，提示无法使用ssl模块。 - 只添加了
D:\Anaconda3\Scripts环境变量，忽略了关键的D:\Anaconda3和D:\Anaconda3\Library\bin目录。
四、解决方案详解
1. 完整配置环境变量
确保系统环境变量中Path包含以下3个路径：
-
D:\Anaconda3- 包含Python主解释器及标准库。
-
D:\Anaconda3\Scripts- 存放pip等命令行工具。
-
D:\Anaconda3\Library\bin- 关键，存放OpenSSL相关的动态库，支持ssl模块正常加载。
注意 ：很多用户只配置了
Scripts，这导致在普通cmd下运行时无法找到SSL的DLL文件。
2. 添加环境变量的步骤
- 右键【此电脑】→【属性】→【高级系统设置】→【环境变量】。
- 在【系统变量】或【用户变量】中找到
Path，点击【编辑】。 - 依次点击【新建】，添加以上三个路径（根据你的Anaconda安装目录修改）。
- 确认保存，关闭所有终端窗口，重新打开普通CMD测试。
3. 测试验证
在新打开的CMD窗口中，执行：
bash
python -c "import ssl; print(ssl.OPENSSL_VERSION)"
pip --version如果正常显示OpenSSL版本号且pip能正常执行，说明配置成功。
五、实战示例
假设Anaconda安装在D:\Anaconda3目录：
| 路径 | 作用 |
|---|---|
| D:\Anaconda3 | Python解释器及核心库 |
| D:\Anaconda3\Scripts | pip和conda命令行工具 |
| D:\Anaconda3\Library\bin | OpenSSL等动态库，支持ssl模块 |
添加后执行：
powershell
set PATH=D:\Anaconda3;D:\Anaconda3\Scripts;D:\Anaconda3\Library\bin;%PATH%
pip install --upgrade pip若无报错即完成配置。
六、附加建议
- 不要手动替换Python自带的OpenSSL库文件，以免破坏环境。
- 使用Anaconda Prompt时系统会自动加载正确环境变量，适合快速使用。
- 若长期使用普通CMD，务必完成上述环境变量配置。
- 如果问题依旧，建议检查Anaconda版本和Python版本是否兼容。
- 遇到SSL相关错误时，也可考虑临时使用HTTP源（非安全），但不建议长期使用。
七、总结
Windows系统下pip报错"ssl module in Python is not available"大多因环境变量配置不完整导致。完整添加Anaconda安装目录及其Scripts和Library\bin路径至系统环境变量，即可解决该问题，恢复pip正常使用。本文希望能帮助大家快速定位并解决该类问题，避免影响开发效率。
八、参考链接
如果你觉得本文对你有帮助，欢迎点赞收藏，或留言讨论！