主要内容

本页采用了机器翻译。点击此处可查看英文原文。

配置用于生成 Python 包的环境

在使用 MATLAB® Compiler SDK™ 运行 Python® 代码或生成 Python 包之前,请通过验证以下内容,确保您的 Python 开发环境已正确配置:

安装受支持的 Python 版本

若要将预打包的 MATLAB 函数集成到您的 Python 代码中,您必须安装一个与 MATLAB Compiler SDK 兼容的 Python 版本。然后,您可以使用代码编辑器编写一个 Python 应用程序,该应用程序集成了由您的 MATLAB 函数生成的 Python 包。您可以按照以下步骤安装兼容版本的 Python:

在虚拟环境中安装 Python

您可以使用 Python 的 venv 模块为特定版本的 Python 创建一个虚拟环境。有关 venv 的说明,请参阅 MATLAB Answers™ 文章使用 MATLAB 的 Python 虚拟环境。请注意,若要使用 MATLAB Compiler SDK 将 MATLAB 代码编译为 Python 包,则无需填写在 MATLAB 中设置部分。有关虚拟 Python 环境的详细信息,请参阅 Python 教程虚拟环境与包

设置环境变量

安装好兼容的 Python 版本后,请设置相应的环境变量。这是为了正确安装使用 MATLAB Compiler SDK 创建的 Python 包所必需的。在命令行中,使用 PYTHONHOME 环境变量设置标准 Python 库的位置。同样地,请使用 PYTHONPATH 环境变量设置模块文件的默认搜索路径,其中包括使用 MATLAB Compiler SDK 打包的 MATLAB 函数。要在命令行中运行 Python,请将您的 Python 安装路径添加到 PATH 中。有关 PYTHONHOME 环境变量的更多信息,请参阅 PYTHONHOME。有关 PYTHONPATH 环境变量的更多信息,请参阅 PYTHONPATH。如果您使用的是虚拟环境,则无需设置 PYTHONPATH

注意

设置 PYTHONHOME 与使用 pyenv 为 MATLAB 设置 Python 解释器不同,后者决定了从 MATLAB 调用 Python 时所使用的 Python 环境。

下表列出了在不同操作系统上设置必要环境变量的步骤。

操作系统过程
Windows®
  1. 运行 C:\Windows\System32\SystemPropertiesAdvanced.exe,然后点击环境变量

  2. 选择要设置的系统变量,然后点击编辑

    如果您在当前使用的计算机上没有管理员权限,请选择同名的用户变量,而不是系统变量。

  3. 点击新建并添加相应的路径。例如,对于环境变量 PYTHONHOME,请添加您的 Python 安装文件夹,例如 C:\Program Files\Python<version>\

  4. 点击确定应用更改。

Linux®

在 Bash shell 中,输入以下命令:

echo "export <ENVIRONMENT_VARIABLE>=<path_to_Python_install>" >> ~/.bash_profile
source ~/.bash_profile
macOS(Mojave 10.14 或更低版本)

在 Bash shell 中,输入以下命令:

echo "export <ENVIRONMENT_VARIABLE>=<path_to_Python_install>" >> ~/.profile
source ~/.profile
对于 PATH,请务必使用以下命令将其添加到 PATH 中:
echo "export <ENVIRONMENT_VARIABLE>=<path_to_Python_install>:$PATH" >> ~/.profile
macOS(Catalina 10.15 或更高版本)

在 Zsh shell 中,输入以下命令:

echo "export <ENVIRONMENT_VARIABLE>=<path_to_Python_install>" >> ~/.zprofile
source ~/.zprofile
对于 PATH,请务必使用以下命令将其添加到 PATH 中:
echo "export <ENVIRONMENT_VARIABLE>=<path_to_Python_install>:$PATH" >> ~/.zprofile

此外,请设置库路径以定位您的 MATLAB Runtime 库。在 Windows 系统中,此路径会自动设置,但在其他平台上则必须手动设置。有关说明,请参阅为部署设置 MATLAB Runtime 库路径

macOS 上运行打包的 MATLAB Code in Python

如果您在 macOS 上运行打包后的 MATLAB 代码,则需要使用 mwpython 命令,而不是标准的 python 命令。

例如,要运行名为 main.py 的 Python 文件,请在终端中执行以下命令:

mwpython main.py

有关更多信息(包括参量和 MATLAB Runtime 启动选项),请参阅 mwpython

某些开发环境可能会默认使用 python 命令来运行 Python 脚本。如果是这种情况,您必须指定一个启动配置,使其通过 mwpython 运行 Python。有关 Visual Studio Code 中调试配置的信息,请参阅调试配置。有关 Anaconda 中工程配置的信息,请参阅工程配置。有关 PyCharm 中运行/调试配置的详细信息,请参阅运行/调试配置

另请参阅

主题