pip list --outdated 查不到某些包，因其默认仅检查 pip 安装的包，不包含 conda、editable 模式（-e）、poetry/pipenv 管理或系统级安装的包；editable 包被视为开发态，版本由源码控制。
pip list --outdated 为什么查不到某些包？
因为 pip list --outdated 默认只检查当前 Python 环境中通过 pip install 安装的包，不包括系统级安装、conda 管理、editable 模式（pip install -e）或由其他工具（如 poetry、pipenv）锁定的包。
- 如果包是用
pip install -e .装的，它不会出现在过期列表里——pip认为这是“开发态”，版本由源码控制 - 使用
conda list --outdated查 conda 环境，别混用pip和conda命令 - 想强制扫描所有包（含用户 site-packages），加
--user参数；但要注意权限冲突风险 - 某些包（如
setuptools、wheel）可能被 pip 自身依赖锁住，升级前会提示Requirement already satisfied或报错ERROR: Cannot uninstall 'X'. It is a distutils installed project
subprocess.run(['python', '-m', 'pip', 'install', '-U', 'pkg']) 的坑
直接拼接字符串调用 subprocess.run("pip install -U pkg") 在 Windows 上容易因空格路径、编码、shell 注入出问题；用列表形式最稳妥，但要注意 Python 解释器路径和 pip 模块一致性。
- 始终用
python -m pip而非裸pip，避免虚拟环境切换时调到系统 pip - 升级多个包时，不要循环多次调
subprocess.run—— 每次启动新进程开销大，改用单次命令：['python', '-m', 'pip', 'install', '-U'] + package_list - 加上
capture_output=True, text=True才能安全读取 stdout/stderr；否则返回的是 bytes，容易在中文环境 decode 失败 - 忽略退出码为 1 的常见情况：比如某个包已是最新版，pip 会返回 0；但遇到依赖冲突时可能返回 1 并打印警告，需检查
result.stderr是否含ERROR或Conflicting dependencies
如何跳过特定包不升级（比如 Django 或 numpy）
没有全局“黑名单”参数，只能在生成待升级列表时过滤。硬编码排除比依赖解析更可靠——因为 pip install -U 不支持 --exclude，且依赖树太深时自动跳过反而导致意外降级。
- 先用
pip list --outdated --format=freeze输出pkg==old->new格式，再按行解析包名 - 用集合存黑名单：
skip = {"django", "numpy", "torch"}，遍历时if pkg_name.lower() not in skip - 注意大小写：PyPI 包名不区分大小写，但
pip list输出可能是首字母大写，统一转小写比对更稳 - 别试图用
--no-deps来规避影响——它会跳过依赖升级，可能导致运行时报ImportError
升级后 import 报错：ModuleNotFoundError 或 symbol not found
这不是脚本写错了，而是新旧版本 API 不兼容或 C 扩展二进制不匹配。批量升级天然有破坏性，必须配合验证环节。
立即学习“Python免费学习笔记（深入）”；
- 升级完立刻跑
python -c "import pkg; print(pkg.__version__)"，确认模块能加载且版本正确 - 对于
numpy、scipy、cv2这类带 C 扩展的包，Windows 上常见ImportError: DLL load failed，通常是 MSVC 运行库版本不匹配，重装对应 wheel 或换 conda 更稳妥 - 如果项目用了
__future__或类型提示，注意 Python 3.12+ 升级typing_extensions后可能触发NameError: name 'Self' is not defined——得同步检查 Python 版本兼容性 - 自动化脚本里别删
__pycache__或.pyc，Python 会自动更新；但若跨大版本（如 3.9→3.11），建议清掉，避免字节码不兼容
真正麻烦的不是升级动作本身，是不同包之间隐式的版本契约——比如一个包声明支持 requests>=2.25.0，另一个却悄悄依赖 requests 里某个 2.28 才加的内部函数。这种事只有运行时才暴露，没法靠脚本静态扫出来。
