旧 Python 装不上（requires-python）

你会遇到什么

Python 3.8 等旧版本执行 pip install deepcode-hku，报找不到匹配版本。包是好的，是你的 Python 太旧。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

包要求 Python >= 3.10（新版依赖如 pydantic 2.x 不支持 3.8）；pip 按 requires-python 过滤后，你的解释器下无可用版本。

pip 的报错容易误导人："No matching distribution" 看起来像"包不存在"，其实是版本过滤器把候选全滤掉了。pip 解析时会读取每个发行版的 requires-python 元数据，和当前解释器版本比对，不满足的直接不进入候选集；所有候选都被滤掉后，就报"找不到匹配版本"。包在 PyPI 上好好的，只是你的解释器不在支持列表里。

所以遇到这个报错，第一步永远是 python3 --version 确认自己的版本，而不是怀疑包名拼错了。

一步步来

1. 确认 Python 版本 — 必做

python3 --version

2. 升级到 3.10+ — 必做

多版本共存用 pyenv/conda 管理，不要动系统默认 Python（避免破坏系统工具依赖）。

3. 重新安装 — 必做

pip install deepcode-hku

怎么确认修好了

安装成功（实测输出形态）：

pip install deepcode-hku
→ Successfully installed deepcode-hku（Python 3.14.4 实测）

deepcode --version（或等价命令）正常输出版本。

其它环境的表现

症状

Python 3.8 等旧版本 pip install deepcode-hku 报找不到匹配版本。

原因

包要求 Python >= 3.10（新版依赖如 pydantic 2.x 不支持 3.8）；pip 按 requires-python 过滤后无可用版本。

解法

1. 升级 Python 到 3.10+（本市场实测 3.14.4 正常）。
2. 多版本共存用 pyenv/conda 管理，不要动系统默认。