MacOS Big Sur安装CPLEX Python API运行报CpoException错误如何解决？

完整报错信息：
CpoException: Executable file should be given in 'execfile' context attribute.

报错原因 #

docplex的约束规划（CP）模块无法自动定位到本地CPLEX Optimization Studio自带的cpoptimizer可执行文件。仅安装pip源的docplex或cplex包不会自带该二进制文件，必须依赖完整安装的CPLEX Optimization Studio。

解决步骤 #

步骤1：确认CPLEX Optimization Studio安装路径 #

Mac下默认安装路径为/Applications/CPLEX_Studio<版本号>/，例如22.11版本的路径为/Applications/CPLEX_Studio2211/，对应cpoptimizer的路径：

• Intel芯片Mac：/Applications/CPLEX_Studio2211/cpoptimizer/bin/x86-64_osx/cpoptimizer
• M系列（M1/M2/M3）芯片Mac：/Applications/CPLEX_Studio2211/cpoptimizer/bin/arm64_osx/cpoptimizer
  请将路径中的版本号替换为你实际安装的CPLEX Studio版本。

步骤2：两种配置方式二选一 #

方式1：代码中临时指定（单次生效）

在初始化求解器的代码前添加以下内容，手动指定可执行文件路径：

from docplex.cp.config import context
# 替换为你本地的cpoptimizer实际路径
context.solver.execfile = "/Applications/CPLEX_Studio2211/cpoptimizer/bin/x86-64_osx/cpoptimizer"

方式2：配置环境变量（永久生效）

打开终端，根据你使用的shell类型编辑对应配置文件：

• 使用zsh（Mac默认shell）：执行nano ~/.zshrc
• 使用bash：执行nano ~/.bash_profile
  在文件末尾添加以下内容，替换为实际路径：

export DOCPLEX_CP_EXECUTABLE="/Applications/CPLEX_Studio2211/cpoptimizer/bin/x86-64_osx/cpoptimizer"

保存退出后执行source ~/.zshrc（或对应bash的配置文件）使配置生效，后续运行代码无需再手动指定路径。

步骤3：验证配置 #

运行以下测试代码，确认配置生效：

from docplex.cp.model import CpoModel
# 构建简单测试模型
mdl = CpoModel()
x = mdl.integer_var(0, 10, "x")
y = mdl.integer_var(0, 10, "y")
mdl.add(x + y == 5)
# 求解
sol = mdl.solve()
# 打印结果
sol.print_solution()

正常运行将输出x和y的可行解，无报错即为配置成功。

常见注意事项 #

• 必须安装完整的IBM ILOG CPLEX Optimization Studio安装包，仅通过pip install cplex安装的依赖不包含cpoptimizer可执行文件
• 路径必须完整指向cpoptimizer二进制文件本身，不要仅填写其所在的父文件夹路径
• M系列芯片Mac请优先选择对应arm64架构的二进制文件，避免使用x86转译带来的性能损耗或兼容性问题

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