pip安装Python包仅生成__pycache__无.py文件、无法导入模块问题求助

• pip配置异常：全局或临时pip配置被篡改，默认携带--compile仅生成字节码、或错误的安装选项参数，导致安装环节跳过源码文件写入。
• 多环境冲突：执行安装的pip和实际运行代码的Python不属于同一环境，包被写入其他环境的site-packages目录，当前环境下仅残留之前运行生成的__pycache__缓存，无实际源码。
• 安全软件拦截：杀毒软件、终端防护规则将.py源码判定为风险文件，安装时直接隔离删除源码，仅缓存文件被保留。
• 包缓存损坏：本地pip缓存的安装包文件损坏，解压时仅能提取字节码缓存，无法正常释放源码。
• 文件系统故障：磁盘写入时出现静默IO错误，源码写入失败但pip未捕获异常，错误返回安装成功状态。

• 第一步：验证环境一致性
  执行以下命令核对pip和Python的包路径是否匹配：

  # 查看当前pip对应的包安装目录
  pip show pip | grep Location
  # 查看当前Python的第三方包搜索路径
  python -c "import sys; print('\n'.join([p for p in sys.path if 'site-packages' in p]))"
  

  若路径不匹配，使用对应Python解释器调用pip重装即可：

  python -m pip install requests --force-reinstall
  

• 第二步：重置pip配置并清空缓存
  先查看所有生效的pip配置，排查异常参数：

  pip config list
  

  存在未知配置项时执行重置，清空缓存后无缓存重装：

  # 清空全局pip配置
  pip config unset global
  # 清空本地pip缓存
  pip cache purge
  # 无缓存强制重装
  pip install requests --force-reinstall --no-cache-dir
  

• 第三步：排查安全软件拦截
  临时关闭杀毒软件、终端实时防护后重新安装，检查包目录下是否正常生成.py源码。确认是拦截问题后，将Python的site-packages目录加入安全软件白名单即可。
• 第四步：修复磁盘文件系统异常
  对包安装目录所在磁盘执行文件系统错误扫描，修复权限异常、坏道等问题后重新尝试安装。

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