pip index versions是首选命令，因它直接查询PyPI官方数据、不依赖本地安装状态、无需额外工具或代码，且自pip 21.2+起开箱即用，输出按发布时间倒序排列的稳定版本列表，准确可靠。
pip index versions 为什么是首选命令
这是目前最直接、最可靠的方式，适用于 pip 21.2+（2021 年后安装的 pip 基本都满足）。它不依赖本地安装状态，也不需要写代码或调外部 API，纯命令行查 PyPI 官方数据。
执行时会返回按发布时间倒序排列的版本列表，最新版在最上面。注意：不是所有版本都会显示全量（比如带 dev、a、b 后缀的预发布版默认被过滤），但稳定版基本齐全。
- 运行
pip index versions requests，输出类似：Available versions for requests: - 2.32.5 - 2.32.4 - 2.32.3 - 2.32.2
- 如果提示
ERROR: unknown command "index"，说明 pip 版本太旧，先升级：pip install -U pip - 某些包名大小写敏感（如
PyYAML不能写成pyyaml），建议先用pip show PyYAML确认准确名称
requests.get("https://pypi.org/pypi/{name}/json") 的实际坑点
手动调 PyPI JSON API 看似灵活，但容易忽略几个关键细节：版本字段不是简单数组，而是字典键；很多键对应的是带元数据的发布记录，真正“可用”的版本得过滤 releases 中非空且有 upload_time 的条目。
-
data["releases"]的 key 是版本号字符串，但值是列表（可能含多个上传文件），空列表表示该版本已 yank 或不可用 - 直接
sorted(data["releases"].keys())是字典序，1.10.0会排在1.9.0前面——必须用packaging.version.parse才能正确排序 - 部分包（如私有源、内部镜像）不走 PyPI，此方法完全失效
pip list --outdated 的误导性
这个命令看起来像能查“所有可选版本”，其实只对比你当前已安装的版本和 PyPI 上的最新版，输出格式固定为三列：Package、Version、Latest。它不会列出历史版本，也不能指定目标包单独查。
- 执行
pip list --outdated | grep requests只能得到一行：requests 2.28.2 2.32.5 - 如果你没装过
requests，它根本不会出现在结果里 - 它依赖网络 + PyPI 可达性，遇到超时或 DNS 问题会静默跳过，不报错
为什么不用 pip search 或 jq 过滤
pip search 自 pip 21.0 起已被彻底移除，现在执行会直接报错 ERROR: Command "search" is not available；而依赖 jq 的方案看似强大，实则引入额外工具链依赖，且 pip list --outdated --format=json 输出里根本没有 versions 字段——所谓“可用版本列表”是虚构的，JSON 结构里只有 name、version、latest_version 三个字段。
- 试图解析
pip list --outdated --format=json得到“所有版本”属于典型误读 - 除非你已用
pip install pypi-simple，否则别信网上那些带jq的示例——它们多数基于过时文档或本地 mock 数据
真正要拿到完整、准确、可排序的版本列表，pip index versions 是唯一开箱即用的方案。其他方式要么失效，要么需要额外处理逻辑，还容易掉进语义陷阱。
