使用pip时出现WARNING: Ignoring invalid distribution -ip警告是什么原因

WARNING: Ignoring invalid distribution -ip (path to packages)

核心原因 #

• 包操作流程异常中断：执行pip install、pip uninstall命令过程中，出现终端意外关闭、进程被强制终止、设备断电/断网等异常情况，会导致pip的包安装/卸载流程未完全执行，在Python的site-packages目录下生成-ip/~ip开头的残缺临时目录。pip扫描已安装的合法包时无法识别这类无效目录，就会重复抛出该警告。
• 低版本pip的逻辑缺陷：21.0以下版本的pip存在临时文件清理逻辑漏洞，即便包操作流程正常结束，也可能偶发残留上述无效目录，持续触发警告。

快速修复方案 #

• 打开警告中提示的path to packages对应的site-packages目录，找到所有命名带-ip、~ip前缀的空目录或残缺安装目录，手动删除即可消除警告。
• 如果删除后警告重复出现，可执行pip install --upgrade pip将pip升级到最新版本，修复底层清理逻辑缺陷。

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