Windows11下运行Docplex.mp模型报错：找不到CPLEX运行时

问题背景 #

已在Windows 11系统安装CPLEX Studio 22.1，通过命令python C:\Program Files\IBM\ILOG\CPLEX_Studio221\python\setup.py install完成Python模块安装，Docplex.cp示例运行正常，但运行Docplex.mp线性规划代码时，出现错误：docplex.mp.utils.DOcplexException: Cannot solve model: no CPLEX runtime found。

解决方案 #

1. 检查Python版本兼容性 #

CPLEX Studio 22.1仅支持Python 3.7至3.10版本，执行python --version查看当前Python版本，若版本不在支持范围内，需切换到兼容的Python环境。

2. 重新安装CPLEX核心模块 #

Docplex MP依赖底层的cplex模块，若该模块未正确安装会导致运行时找不到。操作步骤：

• 以管理员权限打开命令提示符
• 执行完整路径的安装命令（注意引号包裹含空格的路径）：

  python "C:\Program Files\IBM\ILOG\CPLEX_Studio221\python\setup.py" install
  

• 或直接安装对应版本的whl包（在CPLEX的python目录下找到匹配你Python版本的whl文件）：

  pip install "C:\Program Files\IBM\ILOG\CPLEX_Studio221\python\cplex-22.1.0.0-cp39-none-win_amd64.whl"
  

  验证安装：打开Python交互环境，输入import cplex，无报错则说明安装成功。

3. 添加CPLEX路径到系统环境变量 #

将CPLEX的二进制目录添加到系统PATH，确保Python能找到运行时文件：

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在系统变量的PATH中添加：C:\Program Files\IBM\ILOG\CPLEX_Studio221\cplex\bin\x64_win64
• 重启命令提示符或IDE，使环境变量生效。

4. 手动指定CPLEX路径（临时修复） #

在代码开头手动添加CPLEX的Python模块路径，替换路径中的Python版本号为你实际使用的版本：

import sys
sys.path.append(r"C:\Program Files\IBM\ILOG\CPLEX_Studio221\cplex\python\3.9\x64_win64")
from docplex.mp.model import Model

5. 检查IDE的解释器配置 #

如果使用VS Code、PyCharm等IDE，确认当前选中的Python解释器是安装了CPLEX模块的环境，避免使用未配置的虚拟环境或系统默认解释器。

修正后的代码示例 #

原代码存在缩进错误（代码块前有多余空格），会导致语法报错，修正后代码如下：

# Define the Model
from docplex.mp.model import Model
MWMS_model = Model(name="Linear Program")

# Variables
x = MWMS_model.continuous_var(name='x', lb=0)
y = MWMS_model.continuous_var(name='y', lb=0)

# Constraints
c1 = MWMS_model.add_constraint(x + y >= 8, ctname="c1")
c2 = MWMS_model.add_constraint(2*x + y >= 10, ctname="c2")
c3 = MWMS_model.add_constraint(x + 4*y >= 11, ctname="c3")

# Objective Function 
obj = 5*x + 4*y
MWMS_model.set_objective('min', obj)
MWMS_model.print_information()

# Solving
solution = MWMS_model.solve()

# Output
if solution:
    MWMS_model.print_solution()
else:
    print("求解失败，未找到可行解或存在运行时错误")

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