为何不固定版本时pip install package_foo安装失败？

嘿，这个问题的核心根源其实很明确——你的package_foo包版本号bar-0.1.0不符合Python官方的PEP 440版本规范，这才导致pip明明能检测到版本存在，却在默认安装时拒绝选用它。

为啥会出现这种矛盾情况？ #

pip是严格遵循PEP 440标准来处理版本号的，这个标准对版本格式有明确要求：必须是X.Y.Z（基础稳定版）、X.Y.Za1（预发布alpha版）、X.Y.Z.post1（补丁版）或者X.Y.Z+bar（带本地标识的版本）这类格式，绝对不允许像bar-0.1.0这样加自定义前缀。

这就解释了为什么两种安装方式结果不同：

• 当你明确指定版本（比如pip install package_foo==bar-0.1.0）时，pip会直接按你输入的字符串去匹配，完全跳过版本规范校验，所以能成功找到并安装；
• 但你不指定版本直接跑pip install package_foo时，pip会自动启动版本筛选逻辑，只挑选符合PEP 440规范的稳定版本，你的bar-0.1.0会被判定为无效版本，直接被排除在候选列表外，哪怕它是仓库里唯一的版本。

你贴的pip install -vv日志也能证明这一点：日志里清清楚楚写着找到了bar-0.1.0版本，但后续的筛选流程没把它当成有效候选，最后才抛出了找不到匹配发行版的错误。

怎么解决？ #

1. 修正版本号（强烈推荐，一劳永逸）

把你的包版本改成符合PEP 440的格式就行：

• 如果bar是用来标识分支、环境这类额外信息的，用本地版本后缀：0.1.0+bar（PEP 440允许用+来加自定义本地标识，不会影响pip的版本识别）
• 如果不需要额外标识，直接用0.1.0这种标准格式
  改完重新上传到PyPI仓库，之后pip install package_foo就能正常自动安装了。

2. 临时 workaround（不建议长期用）

如果暂时没法改版本号，那每次安装都必须明确指定版本号：

pip install package_foo==bar-0.1.0

或者你可以试试加--pre参数（部分pip版本可能会放宽校验允许安装非规范版本，但这个方案并不稳定，不推荐依赖）。

内容的提问来源于stack exchange，提问作者user4093955