pip安装、卸载、升级包时提示无效分发警告如何解决

• 执行pip相关的Python包安装、卸载、升级操作时，终端固定输出警告信息：WARNING: Ignoring invalid distribution -ip (c:\python39\lib\site-packages)
• 按照警告提示的路径进入c:\python39\lib\site-packages目录后，发现存在~rgcomplete-1.12.2.dist-info这类命名特殊的文件夹，不清楚该类文件的作用与正确处理方式。

带~前缀的.dist-info文件夹是pip操作过程中产生的临时残留：当pip执行包安装、升级、卸载流程时，会先创建临时目录写入新的包元数据，操作完成后再替换为正式目录；如果流程中途因为权限不足、进程被强制终止、手动中断命令等原因异常退出，临时目录就会留在site-packages目录下。
pip扫描本地已安装包列表时，会遍历所有.dist-info后缀的目录，这类不符合命名规范的残留目录无法被正常解析，就会抛出无效分发版本的警告。警告中提到的-ip是残留文件名被截断、乱码后识别出的无效字符，不存在实际名为-ip的损坏包。

• 第一步：关闭所有正在运行的Python进程、pip进程，避免后续操作时文件被占用无法删除。
• 第二步：打开c:\python39\lib\site-packages目录，筛选出所有名称以~开头、后缀为.dist-info的文件夹，直接删除即可。

  注意：仅删除名称带~前缀的.dist-info文件夹，不要改动名称正常、不带特殊前缀的.dist-info目录，否则会导致对应已安装的Python包无法被pip识别，需要重新安装才能修复。

• 第三步：清理完成后执行任意pip命令（比如pip list）验证，之前的无效分发警告就不会再出现。

如果频繁出现这类临时残留，执行pip操作时优先使用管理员权限打开终端，权限不足是pip操作中途异常中断、留下残留文件的最常见原因。

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