Python转Exe后在其他系统运行提示No module named gdal求助

我之前帮不少开发者踩过GDAL打包的这类坑，本质是PyInstaller对GDAL这类C扩展模块的自动识别不够彻底，再加上GDAL本身依赖额外的数据文件和环境变量，咱们一步步来搞定：

1. 先显式指定隐藏导入模块 #

PyInstaller经常漏识别GDAL的子模块，打包时直接用--hidden-import参数把相关模块都列出来：

pyinstaller --hidden-import=gdal --hidden-import=ogr --hidden-import=osgeo --hidden-import=osgeo.gdalconst script.py

如果还是不行，可以直接覆盖osgeo下的所有子模块：--hidden-import=osgeo.*（虽会打包少量冗余模块，但能确保覆盖所有依赖）。

2. 手动修改.spec文件（更可靠的方式） #

PyInstaller生成的.spec文件能精确控制打包内容，步骤如下：

• 先生成初始spec文件：

  pyinstaller script.py
  

• 打开生成的script.spec，修改这几个核心部分：
  1. 在hiddenimports里补全GDAL相关模块：

     hiddenimports=['gdal', 'ogr', 'osgeo', 'osgeo.gdalconst', 'osgeo.osr'],
     

  2. 添加GDAL的核心数据文件（比如投影、坐标系统定义文件）：找到你本机GDAL安装目录下的gdal_data文件夹（conda安装通常在Anaconda3/Library/share/gdal，pip安装可能在Lib/site-packages/osgeo/data/gdal），然后在datas里添加：

     datas=[('C:/path/to/your/gdal_data', 'gdal_data')],
     

  3. 如果你的GDAL有单独的.pyd文件（比如gdal.pyd、ogr.pyd），在binaries里补充：

     binaries=[('C:/path/to/osgeo/gdal.pyd', '.'), ('C:/path/to/osgeo/ogr.pyd', '.')],
     

• 最后用spec文件重新打包：

  pyinstaller script.spec
  

3. 在脚本中手动设置GDAL_DATA环境变量 #

其他机器通常没有GDAL的环境变量配置，所以需要在Python脚本开头添加这段代码，让打包后的exe能找到自带的gdal_data：

import sys
import os

def setup_gdal_env():
    if hasattr(sys, '_MEIPASS'):
        # 打包运行时，MEIPASS是PyInstaller创建的临时目录
        gdal_data_path = os.path.join(sys._MEIPASS, 'gdal_data')
    else:
        # 开发环境下的路径，根据你本机情况修改
        gdal_data_path = r'C:/path/to/your/gdal_data'
    os.environ['GDAL_DATA'] = gdal_data_path
    # 可选：如果用到坐标转换，还需设置PROJ_LIB
    # os.environ['PROJ_LIB'] = os.path.join(sys._MEIPASS, 'proj_lib')

# 先初始化GDAL环境再导入相关模块
setup_gdal_env()
from osgeo import gdal, ogr

4. 检查并补全所有依赖的DLL文件 #

你提到已经带了dll，但GDAL依赖的不止gdal.dll，还需要这些核心文件：

• gdalxxxx.dll（比如gdal304.dll，版本号对应你安装的GDAL）
• ogr.dll
• proj.dll
• geos_c.dll
• sqlite3.dll

可以用Dependency Walker这类工具检查exe的依赖，把缺失的DLL都复制到exe所在目录。

5. 特殊情况：conda安装的GDAL #

如果你的GDAL是用conda安装的，建议先激活对应的conda环境，再用环境内的PyInstaller打包：

conda activate your-gdal-env
pip install --upgrade pyinstaller
pyinstaller --hidden-import=osgeo.* script.py

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