FloPy调用Gridgen报找不到二进制可执行文件错误求助

问题复现 #

使用FloPy开展MODFLOW建模过程中，执行Gridgen对象初始化代码时触发异常：

# 引用Gridgen模块
from flopy.utils.gridgen import Gridgen 
# 初始化工作目录
if not os.path.exists(model_ws):
    os.makedirs(model_ws)
gridgen_ws = os.path.join(model_ws, 'gridgen')
if not os.path.exists(gridgen_ws):
    os.makedirs(gridgen_ws)
print('Model workspace is : {}'.format(model_ws))
print('Gridgen workspace is : {}'.format(gridgen_ws))

# 该行代码触发报错
g = Gridgen(dis, model_ws=gridgen_ws)

抛出的异常信息：

raise Exception("Cannot find gridgen binary executable")
Exception: Cannot find gridgen binary executable

已尝试的无效操作：

• 从USGS下载GRIDGEN程序压缩包放置到指定工作路径
• 修改路径名称、替换不同格式的路径斜杠
• 查阅公开教学资料未找到Gridgen配置说明

根本原因 #

FloPy的Gridgen模块不会自动递归扫描工作目录下的文件，默认仅从两个位置查找gridgen可执行程序：

1. 系统环境变量PATH包含的目录
2. 初始化Gridgen对象时通过exe_name参数显式指定的可执行文件全路径
   仅将程序压缩包放到工作目录、未完成路径注册或显式传参时，就会触发该报错。

解决方案 #

按优先级选择任意一种配置方式即可：

方案1：初始化时显式传入可执行文件全路径（推荐，稳定性最高） #

先解压下载的GRIDGEN压缩包，找到对应系统的可执行文件（Windows系统文件名为gridgen.exe，Linux/macOS文件名为gridgen），复制该文件的完整绝对路径，初始化时传入exe_name参数：

# Windows路径示例，替换为本地实际路径
gridgen_exe = r"D:\softwares\gridgen\gridgen.exe"
# Linux/macOS路径示例
# gridgen_exe = "/home/user/modflow/gridgen/bin/gridgen"

g = Gridgen(dis, model_ws=gridgen_ws, exe_name=gridgen_exe)

注意：

1. 禁止传入压缩包路径，必须是解压后可直接运行的二进制文件路径
2. Linux/macOS系统需要提前给可执行文件添加运行权限，执行命令：chmod +x 你的gridgen文件路径
3. 若下载的是GRIDGEN源码包，需要先完成编译生成可执行文件，无法直接调用

方案2：将可执行文件目录加入系统PATH环境变量 #

将gridgen可执行文件所在的文件夹路径添加到系统PATH环境变量中，配置完成后重启Python解释器，FloPy会自动识别到程序，无需额外传参。

• Windows操作：复制gridgen.exe所在文件夹路径，打开「此电脑-属性-高级系统设置-环境变量」，在用户/系统变量的Path条目中新增该路径，保存后重启终端和Python即可
• Linux/macOS操作：可直接将gridgen可执行文件移动到/usr/local/bin等默认在PATH中的目录，或在shell配置文件（~/.bashrc/~/.zshrc）中追加export PATH=$PATH:你的gridgen所在文件夹路径，执行source命令生效即可

方案3：当前Python进程临时添加搜索路径 #

如果不想修改系统全局环境变量，可以在代码中临时将gridgen所在目录加入进程搜索路径：

import sys
# 替换为本地gridgen可执行文件所在的文件夹路径
gridgen_dir = r"D:\softwares\gridgen"
sys.path.append(gridgen_dir)
# 后续直接初始化即可
g = Gridgen(dis, model_ws=gridgen_ws)

配置验证 #

配置完成后，先打开系统终端/命令提示符，直接输入gridgen（Windows输入gridgen.exe）回车，若能正常输出程序版本、帮助信息，说明配置生效，FloPy可正常调用。

内容的提问来源于stack exchange，提问作者github.Rahul