安装Python包时遇ImportError：无法从setuptools导入setuptools

遇到这个错误大概率是setuptools安装文件损坏、环境冲突或者版本本身的bug，试试下面的解决办法：

• 强制重装setuptools
  直接覆盖现有安装，修复可能的文件缺失或损坏：

  pip install --force-reinstall setuptools==69.5.1
  

• 排查环境冲突

  • 确认pip和Python路径匹配：用which python和which pip（Linux/macOS）或where python和where pip（Windows）查看，确保二者属于同一个环境，避免混用全局和虚拟环境的工具。
  • 如果用了虚拟环境，先激活环境再执行安装操作。

• 清理缓存与残留文件

  • 清空pip缓存：

    pip cache purge
    

  • 手动删除site-packages下的setuptools相关文件夹（比如setuptools、setuptools-69.5.1.dist-info），找到Python安装目录或虚拟环境下的site-packages路径，删除后重新安装。

• 回退到上一稳定版本
  如果最新版69.5.1存在兼容性问题，试试安装上一个版本：

  pip install setuptools==69.5.0
  

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