Ubuntu+Anaconda环境安装MATLAB Engine for Python版本报错咨询

版本检测结果矛盾的原因 #

你遇到的「终端查询Python为3.9.7但安装时提示为3.10」问题，本质是MATLAB Engine安装脚本实际调用的Python解释器，和你执行python3 --version时调用的解释器不是同一个，在Ubuntu+Anaconda环境下常见触发原因如下：

• 执行安装操作前未激活对应Python 3.9的conda虚拟环境，命令行优先调用了全局路径下其他环境的Python 3.10
• 激活了conda环境但安装时加了sudo前缀，sudo会重置PATH环境变量，强制优先调用系统级路径下的Python 3.10，绕过conda环境的路径配置
• 当前环境内python和pip软链接绑定的版本不一致，调用安装命令时实际关联的是Python 3.10解释器

可以在准备安装Engine的命令行窗口执行以下命令验证解释器匹配性，确认输出的版本为3.9、路径属于同一个conda环境后再执行安装即可，全程不要加sudo，conda环境内装包不需要管理员权限：

which python
which pip
python -c "import sys; print(sys.version, sys.executable)"

版本不兼容问题的可行替代方案 #

如果你的常用Python版本确实不在官方Engine支持的版本列表内，可按落地成本从低到高选择以下方案：

• 新建Python 3.9专用conda虚拟环境
  这是稳定性最高、改造成本最低的方案，不会影响现有其他环境的版本配置，创建和激活环境的命令如下，激活后再走官方流程安装Engine即可：

  conda create -n matlab_link python=3.9
  conda activate matlab_link
  # 后续安装项目所需的其他Python依赖、安装MATLAB Engine都在这个环境下操作
  

• 手动修改安装脚本的版本校验规则
  不想额外建虚拟环境的话，可以找到MATLAB安装目录下engines/python/setup.py文件，把代码里写死的支持版本列表添加上你当前使用的Python版本号即可。实测Python 3.10、3.11版本运行基础MATLAB脚本调用功能基本不会出现兼容性问题，仅少数冷门边缘接口可能存在异常，满足日常科研使用需求。
• 跨进程中转调用
  不需要依赖官方Engine，把导师提供的MATLAB脚本做简单封装，支持从命令行接收参数、将运行结果输出到指定文件或本地端口，Python侧通过subprocess模块调起MATLAB命令行执行脚本，再读取返回结果即可。该方案完全不限制Python版本，缺点是参数传递、结果解析的逻辑需要自行编写，大数据量传输效率低于官方Engine。
• 使用第三方开源MATLAB调用库
  社区有不少不需要依赖官方Engine的开源MATLAB调用实现，可直接适配高版本Python，缺点是对新版MATLAB的语法、工具箱支持不一定完整，适合逻辑简单的脚本调用场景。

内容的提问来源于stack exchange，提问作者Troncho Col