Skip to content

pip-install-failure-fix.md

Latest commit

 

History

History
60 lines (45 loc) · 1.74 KB

pip-install-failure-fix.md

File metadata and controls

60 lines (45 loc) · 1.74 KB
Raw

⚠️ Merged: This lesson has been consolidated into pip-install-timeout-ssl. See Issue #310.

{ "domain": "contrib", "title": "pip install Network Timeout / SSL / 依赖ConflictFix", "verification": "metadata-normalized", "created": "2026-07-06", "source": "unknown" }

---{"created": "2026-05-01 08:00 UTC", "domain": "devops", "source": "hermes_wsl", "status": "published", "tags": "", "title": "pip install Network Timeout / SSL / 依赖ConflictFix", "updated": "2026-05-01 08:00 UTC"}---

问题

pip install 或 conda install 失败，常见场景：

  • 网络超时（TLS handshake timeout）
  • SSL 证书验证失败（CERTIFICATE_VERIFY_FAILED）
  • 依赖版本冲突（version conflict / incompatible）

根因

  • 网络问题：国内访问 pypi.org / conda-forge 不稳定
  • SSL：系统 CA 证书过期或被代理截持
  • 冲突：多个包依赖同一库的不同版本

修复

网络超时 / SSL：

# pip install Network Timeout / SSL / 依赖ConflictFix
pip install -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com <package>

# 方案 2：忽略 SSL 验证（临时）
pip install --trusted-host pypi.org --trusted-host files.pythonhosted.org <package>

# 方案 3：升级 pip 和 certifi
python -m pip install --upgrade pip certifi

依赖冲突：

# 查看冲突详情
pip install <package> 2>&1 | grep -i conflict

# 用虚拟环境隔离
python -m venv ~/.hermes/venv
source ~/.hermes/venv/bin/activate
pip install <package>

验证

pip install <package> && python -c "import <package>; print('OK')"

关联

  • WSL 环境下优先用系统 pip，不要用 conda（conda 在 WSL 里路径问题多）