pip list --outdated 是 pip 9.0+ 内置命令，无需安装额外包；它仅比对已装包与 PyPI 官方源的最新兼容版本，不检查 requirements.txt、子依赖、内网源或开发模式安装包，需配合 --format=freeze、--user、--exclude 等参数提升实用性，并人工验证升级安全性。
pip list --outdated 就是你要用的命令，它从 pip 9.0+ 开始就已内置，不需要额外安装任何包——别去 pip install pip-list-outdated，那是个不存在的包，装了反而可能引入无关脚本或污染环境。
为什么 pip list --outdated 有时不显示明显过期的包
不是所有“旧版本”都会被标记为 outdated，背后有几条硬性规则：
- 默认只查 PyPI 官方源（
https://pypi.org/simple/），如果你配了公司内网源但没设对，会完全查不到更新 - 包声明了
python_requires（比如>=3.8），而你当前 Python 是 3.7，pip 就认为“不兼容”，直接跳过，不标 outdated - 用
pip install -e .安装的开发模式包，没有固定版本号，pip list --outdated会忽略它 - 手动删过
dist-info目录、或用--no-deps装过的包，元数据不全，pip 可能识别失败
让输出更实用：加这几个参数
默认输出信息松散，不适合筛选或脚本处理。常用组合如下：
-
--format=freeze：输出形如requests==2.25.1，可直接喂给pip install -U -
--format=json：返回结构化 JSON（需 pip ≥21.3），适合写 Python 脚本解析 -
--user：只检查用户级安装的包，避开系统级干扰 -
--local：排除通过--find-links或私有源安装的包，防止误判 -
--exclude setuptools,pip,wheel：过滤掉构建工具类包，它们频繁发版但业务无关
查某个包具体有哪些可用版本
pip list --outdated 只告诉你“有新版”，但不告诉你“哪些版适配你”。这时候要用：
-
pip index versions（pip ≥21.3）：列出所有与当前 Python 版本兼容的发布版本，例如pip index versions django - 搭配
grep筛选：比如只想看 4.x 系列，加| grep '4\.' - 注意：这个命令不检查本地是否已安装，只查源上的版本清单
真正容易被忽略的一点是：pip list --outdated 完全不看 requirements.txt 或 pyproject.toml 里的约束，也不管子依赖有没有漏洞。它只回答一个朴素问题：“我当前装的这个包，在 PyPI 上有没有更高版本？” 其他所有判断——该不该升、能不能升、升了会不会崩——都得你人工补上。
