PyCharm使用matlab引擎报错：ModuleNotFoundError: No module named 'matlab'

一、解决PyCharm的ModuleNotFoundError问题 #

你在Python Shell中能正常导入但PyCharm报错，核心原因是PyCharm使用的Python解释器与Shell不一致，或者解释器路径未包含matlab模块。按以下步骤操作：

1. 对齐Shell与PyCharm的Python解释器

   • 打开Python Shell，执行：import sys; print(sys.executable)，复制输出的Python可执行文件完整路径。
   • 打开PyCharm，点击右下角的Python版本标识（如Python 3.9），选择「Interpreter Settings」。
   • 在弹出窗口中，点击右上角齿轮图标→「Add」→「Existing environment」，把刚才复制的路径粘贴到「Interpreter」输入框，点击「OK」设置为项目默认解释器。

2. 手动添加matlab模块路径（若上述方法无效）

   • 回到PyCharm的解释器设置页面，选中目标解释器，点击齿轮图标→「Show All...」。
   • 在解释器列表中选中当前使用的解释器，点击底部的「Show paths for the selected interpreter」（文件夹图标）。
   • 点击「+」按钮，添加matlab模块所在路径：
     • 若已安装过MATLAB引擎，路径通常为Python安装目录\Lib\site-packages\matlab
     • 或MATLAB安装目录下的extern\engines\python\build\lib

二、解决MATLAB引擎安装时「Python is not found」的问题 #

该错误是由于当前cmd环境未识别到你要使用的Python版本，可通过以下方式解决：

1. 使用Python完整路径执行安装命令

   • 找到你的Python可执行文件路径（如C:\Users\XXX\AppData\Local\Programs\Python\Python39\python.exe）。
   • 以管理员身份打开cmd，进入MATLAB引擎的python目录：cd "C:\Program Files\MATLAB\R2023a\extern\engines\python"（替换为你的MATLAB版本路径）。
   • 执行安装命令，把python替换为完整路径：

     "C:\Users\XXX\AppData\Local\Programs\Python\Python39\python.exe" setup.py install
     

2. 将Python添加到系统PATH（永久解决cmd找不到Python的问题）

   • 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
   • 在系统变量的「Path」中，点击「新建」，添加Python安装目录（如C:\Users\XXX\AppData\Local\Programs\Python\Python39）和Scripts目录（C:\Users\XXX\AppData\Local\Programs\Python\Python39\Scripts）。
   • 点击「确定」保存，重启cmd后再执行python setup.py install即可。

3. 无需管理员权限的安装方式

   • 若管理员权限操作仍有问题，可添加--user参数安装到用户目录：

     python setup.py install --user
     

额外检查项 #

• 确认你的MATLAB版本与Python版本兼容，比如R2023a支持Python 3.8-3.11，R2022b支持3.7-3.10，核对版本适配要求。
• 安装MATLAB引擎前，关闭所有MATLAB进程。

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