配置用于生成 Python 包的环境
在使用 MATLAB® Compiler SDK™ 运行 Python® 代码或生成 Python 包之前,请通过验证以下内容,确保您的 Python 开发环境已正确配置:
您的开发系统使用的 Python 版本与 MATLAB 兼容。有关更新的 Python 系统要求,请参阅 MATLAB 与其他语言的接口。
Python 包含在系统的
PATH中。您的目标计算机已安装 MATLAB 或 MATLAB Runtime。有关目标计算机要求的更多信息,请参阅 MATLABCompiler SDK Python 目标要求。有关如何安装 MATLAB Runtime 的说明,请参阅下载并安装 MATLAB Runtime。
安装受支持的 Python 版本
若要将预打包的 MATLAB 函数集成到您的 Python 代码中,您必须安装一个与 MATLAB Compiler SDK 兼容的 Python 版本。然后,您可以使用代码编辑器编写一个 Python 应用程序,该应用程序集成了由您的 MATLAB 函数生成的 Python 包。您可以按照以下步骤安装兼容版本的 Python:
访问 https://www.python.org/downloads/,并滚动至查找特定版本部分
找到您想要的版本,然后点击下载。有关受支持版本的信息,请参阅按版本划分的与 MATLAB 产品兼容的 Python 版本。
点击您所需的 64 位版本,并按照在线说明操作。
在虚拟环境中安装 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® |
|
| Linux® | 在 Bash shell 中,输入以下命令: echo "export <ENVIRONMENT_VARIABLE>=<path_to_Python_install>" >> ~/.bash_profilesource ~/.bash_profile |
| macOS(Mojave 10.14 或更低版本) | 在 Bash shell 中,输入以下命令: echo "export <ENVIRONMENT_VARIABLE>=<path_to_Python_install>" >> ~/.profilesource ~/.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>" >> ~/.zprofilesource ~/.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 中运行/调试配置的详细信息,请参阅运行/调试配置。