CPLEX 20.1.0配置Python API提示Python版本不兼容报错如何解决

你遇到的报错本质是执行安装命令时调用的Python解释器，和你单独敲python命令调用的不是同一个版本，Windows系统下py是Python官方的启动器，会优先调用系统注册的最高版本Python，和python命令的关联逻辑完全独立。

第一步：定位问题根源 #

执行以下命令确认py启动器关联的版本：

py -V

如果输出为Python 3.9.x，即可确认是启动器关联版本错误导致的问题。

第二步：优先推荐解决方案（适配你已安装的Python3.7） #

• 退出当前的3.8\x64_win64目录，进入CPLEX对应Python3.7的安装路径：C:\Program Files\IBM\ILOG\CPLEX_Studio201\cplex\python\3.7\x64_win64
• 直接用你验证过版本的python命令执行安装，不要用py命令：

python setup.py install

提示：执行该步骤建议用管理员权限打开命令提示符，避免Program Files目录的写入权限报错。

第三步：可选解决方案（使用Python3.8版本CPLEX） #

如果你需要使用3.8版本的CPLEX API，可按以下操作：

1. 先安装Python3.8版本并配置好环境变量
2. 回到当前的3.8\x64_win64目录，执行安装命令时指定Python版本：

py -3.8 setup.py install
# 或者直接调用Python3.8的绝对路径，示例：
# C:\Python38\python.exe setup.py install

第四步：清理残留Python3.9避免后续问题 #

如果确认你不需要Python3.9，可按以下操作清除残留：

• 打开控制面板→程序和功能，搜索Python，卸载所有带3.9标识的程序
• 右键此电脑→属性→高级系统设置→环境变量，在系统变量的Path中删除所有带Python39字样的路径，将你常用的Python3.7路径上移到最顶部
• 如果使用了Anaconda/Miniconda等环境管理工具，检查是否有全局激活的3.9版本环境，退出即可

安装验证 #

执行以下命令验证安装是否成功，正常输出版本号即为配置完成：

python -c "import cplex; print(cplex.__version__)"

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