site-packages目录~前缀文件的成因、报错排查及预防方法咨询

我之前也碰到过一模一样的问题！这种带~前缀的残留文件确实会搞砸pip的安装流程，先给你拆解下背后的原因和靠谱的预防办法：

• 安装中断/异常退出：最常见的情况——pip在安装包的过程中，会先创建临时的占位文件或者半生成的目录，要是中途因为网络断了、权限突然变化、进程被强制杀死（比如手动Ctrl+C终止安装），这些临时文件没被正常清理，就可能留下这类带~的残留。你遇到的~ycparser-2.19.dist-info就是典型的半生成目录没删干净。
• 文件系统权限冲突：当你用非root用户安装系统级Python包（比如你这里的/opt/ute/python/lib/python2.7/site-packages/是系统目录），pip在尝试写入时可能因为权限不足，导致文件写入到一半失败，残留了残缺的临时文件，文件名里的~就是pip用来标记临时状态的。
• 旧版pip的bug：比较老的pip版本（尤其是Python2.7配套的pip，毕竟Python2已经停止维护了），在处理分布式包的dist-info目录时，可能存在清理逻辑的漏洞，安装失败后不会自动删除临时生成的带~的文件。

• 优先用虚拟环境：别直接碰系统级的Python包！用virtualenv创建独立的虚拟环境，所有包都装在虚拟环境里，既不会污染系统目录，权限问题也少很多，就算安装失败，清理虚拟环境重新建一个也方便。针对Python2.7，先装virtualenv：pip install virtualenv，然后创建并激活环境：

  virtualenv my_py2_env
  source my_py2_env/bin/activate
  

• 安装时加--user参数：如果非要装在用户目录而不是系统目录，用pip install pycparser --user，这样包会被装到你用户目录下的.local/lib/python2.7/site-packages/，不需要系统权限，也不会产生权限导致的残留文件。
• 升级到兼容的最新pip版本：虽然Python2.7的pip已经停更了，但最后兼容的版本是pip 20.3.4，升级后能修复不少旧bug（包括临时文件清理的问题）：pip install --upgrade pip==20.3.4。
• 安装前检查清理残留：每次安装包前，先手动检查下site-packages目录里有没有带~的残留文件/目录，发现了就删掉。也可以用脚本批量清理（注意确认是残留再执行！）：

  find /opt/ute/python/lib/python2.7/site-packages/ -name "*~*" -type d -exec rm -rf {} \;
  

• 避免强制终止安装进程：安装过程中尽量别手动Ctrl+C或者杀进程，要是真的卡住了，先等一会儿，实在不行再终止，之后一定要记得清理可能的残留文件。

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