Main Content

安装用于 PythonMATLAB Engine API

要在 Python® 会话中启动 MATLAB® Engine,首先必须将该引擎 API 安装为 Python 包。有关其他需求,请参阅MATLAB Engine API for Python 的系统要求

验证您的配置

在安装之前,确认您的 Python 和 MATLAB 配置。

  • 检查您的系统是否具有受支持的 Python 版本和 MATLAB R2014b 或更新版本。有关详细信息,请参阅 MATLAB 产品(按版本)兼容的 Python 版本

  • 要检查您的系统上是否已安装 Python,请在操作系统提示符下运行 Python。确保 Python 路径包含在您的系统路径环境变量中。

  • 将包含 Python 解释器的文件夹添加到您的路径(如果尚未在该路径中)。

安装引擎 API

您可以使用 pip 命令或 Python 设置脚本 setup.py 安装 MATLAB Engine API for Python。

使用 pip 进行安装

从 MATLAB R2022b 开始,您可以使用 pip 命令来安装 API。选择以下过程之一,并在系统提示符下执行。

  • 要从 MATLAB 文件夹安装,请在 Windows® 上键入:

    cd "matlabroot\extern\engines\python"
    python -m pip install .
  • 使用以下命令从 https://pypi.org/project/matlabengine 安装引擎 API:

    python -m pip install matlabengine

使用 setup.py 进行安装

MATLAB 提供了标准的 Python setup.py 文件,用于使用 Python setuptools 编译和安装引擎。有关特定于平台的命令,请参阅用于安装 MATLAB Engine API 的 Python 设置脚本

启动 MATLAB Engine

启动 Python。在 Python 提示符下键入以下命令,以导入 MATLAB 模块并启动引擎:

import matlab.engine
eng = matlab.engine.start_matlab()

有关详细信息,请参阅启动和停止用于 Python 的 MATLAB 引擎

用于 PythonMATLAB Engine API 安装故障排除

  • 请确保您的 MATLAB 版本支持您的 Python 版本。请参阅 MATLAB 产品(按版本)兼容的 Python 版本

  • 确保您有足够的特权以从操作系统提示符执行安装命令。在 Windows 上,如有必要,使用 以管理员身份运行 选项打开命令提示符。

  • 您必须从指定的 MATLAB 文件夹中运行 Python 安装命令。有关详细说明,请选择 安装引擎 API 中的平台链接之一。

    python setup.py install
    
  • 安装程序将引擎安装在默认的 Python 文件夹中。要使用非默认位置,请参阅在非默认位置安装用于 Python 的 MATLAB Engine API

  • 如果您使用 --prefix 将包安装在非默认文件夹中,请确保设置 PYTHONPATH 环境变量。例如,假设您使用了以下安装命令:

    python setup.py install --prefix="matlab22aPy39"
    

    在 Python 中,使用以下命令更新 PYTHONPATH

    sys.path.append("matlab22aPy39\Lib\site-packages")
  • 有关故障排除的详细信息,请参阅Troubleshoot MATLAB Errors in Python

相关主题