ModuleNotFoundError: No module named ‘matlab.engine‘； ‘matlab‘ is not a package 的参考解决方法

写在前面

自己的环境:
Ubuntu 20.04
Matlab R2020b

一、问题描述

在 python 中调用 Matlab 时，运行编写的 python 文件，遇到如下问题：

ModuleNotFoundError: No module named 'matlab.engine'; 'matlab' is not a package

遇到的问题详细描述：

自己新建了一个 conda 环境 pytorch_env，然后在这个环境下进入 python (自己是python3.8)，然后执行 import matlab.engine ,就会出现上述报错 ModuleNotFoundError: No module named 'matlab.engine'; 'matlab' is not a package

然而，如果自己切换到 root 用户下，再次执行 import matlab.engine , 却并不会出现报错。
(root 用户下不能进入到 anaconda 的 pytorch_env 环境 )

二、解决方法

按照 参考链接1 , 在自己的 matlab 安装目录下，自己的matlab安装目录为/matlab/Polyspace/R2020b，

cd /matlab/Polyspace/R2020b/extern/engines/python

然后 依次执行下面四条指令就可以成功解决问题。

python setup.py build --build-base="builddir" install
python setup.py install --prefix="installdir"
python setup.py build --build-base="builddir" install --prefix="installdir"
python setup.py install --user

如果成功解决问题，那么就可以不再向下看，如果还没有解决问题，请继续向下看。

由于自己并没有成功解决上述问题。所以通过 参考链接[2] ，猜测可能是 个人账户python的搜索路径未包含matlab文件。因此，对比了root账户下的python文件夹和 个人账户的python文件夹后，发现如下区别：

1. 首先是root账户下的python文件夹：
   执行指令 python -m site --user-site 确定当前 python 包的安装位置为 /root/.local/lib/python3.8/site-packages:
   
   参考链接4 以root 身份 进入到 /root/.local/lib/python3.8/site-packages 文件夹下，有如下文件：
   
2. 其次是个人账户wong下的python文件夹：
   执行指令 python -m site --user-site 确定当前 python 包的安装位置为 /home/wong/.local/lib/python3.8/site-packages:

然后进入到 /home/wong/.local/lib/python3.8/site-packages 文件夹下，并没有找到 matlab 相关的文件夹或文件。
因此，将root账户下的 matlab 文件夹复制到 个人账户的对应位置，就可以解决上述问题。
3. 将root账户下的 matlab 文件夹复制到 个人账户的对应位置
将 /root/.local/lib/python3.8/site-packages 下的 matlab 文件夹复制到 /home/wong/.local/lib/python3.8/site-packages 下就可以解决问题。

三、其他可能的解决方法 （备选）

在/matlab/Polyspace/R2020b/extern/engines/python 目录下，

cd /matlab/Polyspace/R2020b/extern/engines/python

执行下述四条指令之后，

python setup.py build --build-base="builddir" install
python setup.py install --prefix="installdir"
python setup.py build --build-base="builddir" install --prefix="installdir"
python setup.py install --user

在当前目录会变成如下几个文件：

其中，dist/下会有一个 matlab 文件夹, 这个是源程序文件，build/lib/ 下会有一个 matlab 文件夹，这个文件夹是编译之后生成的。
如果将 build/lib/ 下的 matlab 文件夹复制到 /home/wong/.local/lib/python3.8/site-packages 下也是可以解决问题。
但是将 dist/ 下的 matlab 文件夹复制到 /home/wong/.local/lib/python3.8/site-packages 下是不可以解决问题。

参考链接

[1] 爱吃骨头的猫、. Tips–解决No module named matlab.engine的问题 [EB/OL]. https://blog.youkuaiyun.com/qq_42580947/article/details/106837408, 2020-06-18/2024-05-25.
[2] 昨日啊萌. 服务器上Python和matlab混编时，遇到问题：‘matlab‘ is not a package的解决方法 [EB/OL]. https://blog.youkuaiyun.com/qq_37395293/article/details/108943387, 2020-10-06/2024-05-25.
[3] Python Conda环境下site-packages的位置 [EB/OL]. https://geek-docs.com/python/python-ask-answer/280_python_where_is_sitepackages_located_in_a_conda_environment.html, xxxx-xx-xx/2024-05-25.
[4] wongHome. Linux Ubuntu 如何以root身份打开文件管理器 [EB/OL]. https://blog.youkuaiyun.com/qq_39779233/article/details/114277598, 2021-03-02/2024-05-25.