安装用于 Python 的 MATLAB Engine API
MATLAB® Engine API for Python® 允许您从 Python 环境中调用 MATLAB 函数并执行 MATLAB 命令。要使用 MATLAB 引擎，您必须在计算机上安装受支持的 Python 版本，并且必须将 MATLAB Engine API for Python 作为 Python 包安装。
验证您的配置并安装 Python
如果您安装了 Python，请验证您使用的是 MATLAB 引擎支持的版本。您可以通过在操作系统提示符下输入 python -V 来检查在 Windows® 系统上安装的 Python 的具体版本。在 Linux® 或 macOS 系统上，请改用 python3 -V。然后通过检查 MATLAB 产品（按版本）兼容的 Python 版本页来确定您的 Python 版本是否与您的 MATLAB 版本兼容。
此外，请验证您使用的是 64 位版本的 Python。64 位版本的 Python 是匹配 MATLAB 架构所必需的。要测试您的 Python 版本是 32 位还是 64 位，请在 Python 提示符下输入以下代码。如果版本是 64 位，则以下代码返回 True，如果版本是 32 位，则返回 False。
import sys
print(sys.maxsize > 2**32)如果您未安装 Python 或需要不同版本，请参阅配置您的系统以使用 Python。
安装用于 Python 的 MATLAB Engine API
MATLAB 提供多种安装 MATLAB Engine API for Python 的方法。您也可以使用 MATLAB 附带的预安装版本的 MATLAB Engine API for Python。 (自 R2026a 起)
从 MATLAB 安装
您可以直接从 MATLAB 安装 MATLAB 引擎。启动 MATLAB 并运行以下命令。
| 系统 | MATLAB 命令 |
|---|---|
Windows |
cd (fullfile(matlabroot,"extern","engines","python")) system("python -m pip install .") |
Linux 和 macOS |
cd (fullfile(matlabroot,"extern","engines","python")) system("python3 -m pip install .") |
从操作系统安装
您也可以从操作系统提示符安装 MATLAB 引擎。首先，您需要 MATLAB Engine API for Python 文件夹的路径。要定位此文件夹，请启动 MATLAB 并在命令行窗口中输入 matlabroot。然后用 MATLAB 返回的路径值替换以下命令中的 matlabroot。
确保您有足够的特权以从操作系统提示符执行 install 命令。在 Windows 上，如有必要，使用以管理员身份运行选项打开命令提示符。
| 系统 | 系统命令 |
|---|---|
Windows |
cd "matlabroot\extern\engines\python"
python -m pip install .
|
Linux 和 macOS |
cd "matlabroot/extern/engines/python"
python3 -m pip install .
|
从 Python Package Index 安装
您也可以从 Python Package Index (PyPI) 安装 MATLAB 引擎。与其他安装选项不同，您不需要先导航到 MATLAB Engine API for Python 文件夹。
要从 PyPI 安装最新版本的 MATLAB 引擎，请从操作系统提示符运行以下命令：
python -m pip install matlabengine
最新 MATLAB 引擎版本仅与最新 MATLAB 版本（当前为 R2026a）兼容。它与 MATLAB 的预发行版本不兼容。
如果您没有最新版本的 MATLAB，请指定与您的版本兼容的 MATLAB 引擎的版本。从您的操作系统提示符运行以下命令，其中 n.n.n
python -m pip install matlabengine==n.n.n
要确定哪个版本与您的 MATLAB 版本兼容，请执行以下操作：
打开每个 MATLAB 引擎版本页，并将必需的 MathWorks 产品下显示的 MATLAB 版本与您的 MATLAB 版本进行比较，直到找到匹配项。
然后，您可以将
n.n.n
PyPI 将 MATLAB 引擎安装到用于调用 MATLAB 引擎安装程序的 Python 解释器的默认包文件夹中。要在非默认文件夹中安装引擎，请从操作系统提示符运行以下命令，其中 installdir
python -m pip install --target installdir matlabengine
要将 installdirinstalldirPYTHONPATH 环境变量中。
使用预安装版本的 MATLAB Engine API for Python
自 R2026a 起
MATLAB 包含预安装版本的 MATLAB Engine API for Python。此预安装版本的引擎位于 matlabroot/extern/engines/python/distmatlabrootmatlabroot 时显示的文件夹。
要使用预安装版本的 MATLAB 引擎，请将 matlabroot/extern/engines/python/distPYTHONPATH 环境变量。您也可以在导入引擎之前将其插入 Python 的 sys.path 中。
在虚拟环境中安装
您可以在虚拟环境中安装 MATLAB Engine API for Python。有关在虚拟环境中安装 MATLAB Engine API for Python 的详细说明，请参阅 MATLAB Answers™ 文章在虚拟环境中使用 MATLAB Engine API for Python。有关虚拟 Python 环境的信息，请参阅 Python 教程虚拟环境和包。在运行安装命令之前，您必须激活虚拟环境。
在 Python 中启动 MATLAB 引擎
要导入 MATLAB Engine API for Python 包并启动 MATLAB 引擎，请从 Python 提示符运行以下命令。
import matlab.engine
eng = matlab.engine.start_matlab()
有关详细信息，请参阅启动和停止用于 Python 的 MATLAB 引擎。
