PyInstaller打包后运行报错：无法从numpy.distutils导入ccompiler求助

该问题的核心原因是1.23及更高版本的numpy已经正式废弃并移除了numpy.distutils模块，而你依赖的fiona、rasterio、geopandas等地理空间库的旧版本仍存在对该模块的隐式调用，PyInstaller依赖扫描时无法适配该变更，才会触发先后两次报错。
可按以下优先级尝试解决：

• 方案1：降级numpy到兼容版本
  直接安装仍保留numpy.distutils模块的1.22.x稳定版即可，执行命令：

  pip install numpy==1.22.4
  

  安装完成后先在本地运行原代码确认所有导入正常，再重新执行打包命令，不需要额外添加numpy.distutils到隐藏导入。
• 方案2：调整打包参数排除冲突模块
  如果你必须使用高版本numpy，不需要手动添加numpy.distutils到隐藏导入，直接在打包时添加排除参数，同时补全地理库的隐藏导入即可，打包命令示例：

  pyinstaller -F --hidden-import fiona._shim --hidden-import rasterio._shim --hidden-import geopandas._compat --exclude-module numpy.distutils 你的主程序文件名.py
  

• 方案3：通过spec文件配置打包规则
  如果上述命令行参数配置不生效，可以先生成spec文件，在Analysis区块中明确配置要导入的依赖和要排除的冲突模块，参考配置如下：

  a = Analysis(
      ['你的主程序文件名.py'],
      pathex=[],
      binaries=[],
      datas=[],
      hiddenimports=['fiona', 'rasterio', 'geopandas', 'rasterstats', 'pyodbc', 'PySimpleGUI'],
      hookspath=[],
      hooksconfig={},
      runtime_hooks=[],
      excludes=['numpy.distutils'],
      win_no_prefer_redirects=False,
      win_private_assemblies=False,
      cipher=None,
      noarchive=False,
  )
  

  配置完成后执行pyinstaller 你的spec文件名.spec即可完成打包。
• 额外排查点
  如果执行上述操作后仍报错，先执行pip uninstall -y numpy完全卸载当前环境所有numpy版本，再重新安装对应版本的numpy，避免多版本残留冲突。

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