pip list --outdated仅比对pypi最新兼容版本，不考虑python版本、requirements.txt、内网源、预发布版及开发模式安装包；需用--format=freeze、--exclude、--user等参数筛选，并人工验证兼容性与变更影响。
pip list --outdated 是最直接的命令，但它列出的“可更新”不等于“该更新”——多数时候你得手动筛一遍才能动手。
为什么 pip list --outdated 的结果不能直接信
它只比对 PyPI 上最新发布的兼容版本，不看你的 Python 版本是否支持、requirements.txt 是否锁死、镜像源是否同步、甚至不包含 pip install -e . 安装的开发包。常见误导场景包括：
-
setuptools、wheel、importlib-metadata频繁发版，但业务代码几乎不受影响，却总占满列表 - PyPI 上标着
2.10.0b1这类预发布版，pip list --outdated会把它当“最新版”推给你 - 你用的是公司内网源，但没配
pip config set global.index-url，它仍去公网查，结果可能漏掉内部已发布的安全补丁 - 某些包（如
numpy）在 Python 3.14.2 下最新稳定版其实是1.28.3，但 PyPI 上已有2.0.0rc2，--outdated会优先显示后者
让输出真正可操作的三个关键参数
默认表格格式人眼难扫，也难喂给脚本。加这几个参数能立刻提升实用性：
-
pip list --outdated --format=freeze：输出形如requests==2.28.1，可直接复制进pip install -U或存为临时升级清单 -
pip list --outdated --exclude setuptools,pip,wheel,importlib-metadata：过滤掉基础设施类包，聚焦你真正写的业务代码依赖 -
pip list --outdated --user：只查用户级安装（适合没权限动系统环境或用--user装包的场景）
注意：--format=json 仅在 pip ≥ 21.3 支持，老版本会报错；不确定就先跑 pip --version 确认。
Webnovel Serial Pipeline
下载
构建并发布在 Quartz 平台上的韩语网络小说连载（草稿→封面→webp→章节 md→lint→发布），使用 Nano Banana Pro + ffmpeg。
怎么确认某个包“真能升”而不是“只是有新版”
pip list --outdated 只回答“有没有新版本”，不回答“能不能升”。升级前必须人工验证：
- 查支持的 Python 版本：运行
pip index versions <package_name></package_name>（例如pip index versions django），看哪些版本明确标注支持你当前的Python 3.14.2 - 检查变更日志：特别是 major 版本跃迁（比如从
urllib3 1.x升到2.x），常伴随 API 删除或行为变更 - 留意 CVE 编号：如果某次更新修复了
CVE-2025-12084这类高危漏洞，哪怕只是 patch 版也要优先处理
批量升级不是一键的事，别信 --all
pip install --upgrade --all 是无效命令，会报错 ERROR: unrecognized arguments: --all。真要批量操作，得组合使用：
- Linux/macOS：
pip list --outdated --format=freeze | grep -v '^-e' | cut -d = -f 1 | xargs -n1 pip install -U - Windows PowerShell：
pip list --outdated --format=freeze | ForEach-Object { $_.Split('==')[0] } | ForEach-Object { pip install -U $_ }
但强烈建议：别在主环境直接跑。先建干净虚拟环境，pip install -r requirements.txt 复现依赖，再测试升级后是否 break。
pyarrow、psycopg2）的兼容性边界已经变了，光看版本号没用，得跑实际 workload。
