一、問題背景

在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. 添加環境變量的步驟

1. 右鍵【此電腦】→【屬性】→【高級系統設置】→【環境變量】。
2. 在【系統變量】或【用戶變量】中找到Path，點擊【編輯】。
3. 依次點擊【新建】，添加以上三個路徑（根據你的Anaconda安裝目錄修改）。
4. 確認保存，關閉所有終端窗口，重新打開普通CMD測試。

3. 測試驗證

在新打開的CMD窗口中，執行：

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模塊

添加后執行：

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正常使用。本文希望能幫助大家快速定位并解決該類問題，避免影響開發效率。

---

八、參考鏈接

• Anaconda官方環境變量說明
• Python ssl模塊官方文檔
• StackOverflow相關討論

---

如果你覺得本文對你有幫助，歡迎點贊收藏，或留言討論！