下载并安装 MATLAB Runtime

支持的平台：Windows®、Linux®、macOS

MATLAB® Runtime 包含无需 MATLAB 的许可副本即可在目标系统上运行编译的 MATLAB 应用程序所需的库。有关详细信息，请参阅关于 MATLAB Runtime。

下载 MATLAB Runtime 安装程序

使用以下选项之一下载 MATLAB Runtime 安装程序：

  • 从网站 https://www.mathworks.com/products/compiler/matlab-runtime.html 下载最新更新级别与选定版本对应的 MATLAB Runtime 安装程序。此选项最适合想要运行部署的应用程序的最终用户。

  • 使用 MATLAB 函数 compiler.runtime.download 下载与执行命令的 MATLAB 版本和更新级别相匹配的 MATLAB Runtime 安装程序。如果该安装程序已下载到计算机，它将返回 MATLAB Runtime 安装程序的路径。如果计算机处于离线状态，它将返回 MATLAB Runtime 安装程序的 URL。此选项最适合想要创建包含 MATLAB Runtime 的应用程序安装程序的开发人员。

  • 使用 MATLAB 函数 compiler.runtime.customInstaller (自 R2024b 起) 创建 MATLAB Runtime 安装程序，该安装程序仅安装运行使用 MATLAB Compiler™ 或 MATLAB Compiler SDK™ 创建的指定工件所需的 MATLAB Runtime 组件。此选项最适合需要占用空间最小且只能运行特定应用程序的安装程序的开发人员。

注意

如果要将 MATLAB Runtime 安装到共享网络驱动器，请参阅在网络驱动器上部署应用程序和 MATLAB Runtime。

要下载包含 MATLAB Runtime 的 Docker® 镜像，请参阅MATLAB Runtime 容器。

以交互方式安装 MATLAB Runtime

要安装 MATLAB Runtime，请执行以下操作：

  1. 提取包含 MATLAB Runtime 安装程序的存档。安装程序文件名的版本部分（例如 _R2025b_）因版本而异。

    平台步骤
    Windows

    解压缩 MATLAB Runtime 安装程序。

    右键点击 ZIP 文件 MATLAB_Runtime_R2025b_win64.zip 并选择全部解压缩。

    Linux

    使用 unzip 命令在终端解压缩 MATLAB Runtime 安装程序。

    例如，如果您解压缩的是 R2025b MATLAB Runtime 安装程序，请在终端输入：

    unzip MATLAB_Runtime_R2025b_glnxa64.zip

    macOS

    使用 unzip 命令在终端解压缩 MATLAB Runtime 安装程序。

    对于基于 Intel® 处理器的 macOS，请输入：

    unzip MATLAB_Runtime_R2025b_maci64.zip

    对于基于 Apple 芯片的 macOS，请输入：

    unzip MATLAB_Runtime_R2025b_maca64.zip

  2. 启动 MATLAB Runtime 安装程序。

    平台步骤
    Windows

    双击所提取的文件中的 setup.exe 文件以启动安装程序。

    Linux

    在终端输入：

    sudo -H ./install

    仅当安装到您没有写访问权限的目录时才需要 sudo。

    注意

    您可能需要允许根用户访问正在运行的 X 服务器：

    xhost +SI:localuser:root
sudo -H ./install
xhost -SI:localuser:root

    macOS

    双击 DMG 文件以启动安装程序。

  3. 当 MATLAB Runtime 安装程序启动时，它会显示一个对话框。阅读信息，然后点击下一步以继续安装。

  4. 在文件夹选择对话框中，指定要安装 MATLAB Runtime 的文件夹。

    您的计算机上可以安装多个版本的 MATLAB Runtime，但每个特定版本只能安装一次。如果您已经安装了相同版本，MATLAB Runtime 安装程序将不会显示文件夹选择对话框，因为它会覆盖同一文件夹中的现有安装。

    小心

    安装路径不得包含任何非 ASCII 字符。

  5. 确认您的选择并点击下一步。

    MATLAB Runtime 安装程序开始将文件复制到安装文件夹中。

  6. 在 Linux 和 macOS 平台上，将文件复制到磁盘后，MATLAB Runtime 安装程序将显示产品配置说明对话框。此对话框包含设置路径环境变量所需的信息。从此对话框中复制路径信息，将其保存到文本文件，然后点击下一步。

    有关设置路径环境变量的说明，请参阅针对部署设置 MATLAB Runtime 路径。

  7. 点击完成以退出安装程序。

默认安装文件夹

下表中指定了 R2025b 的默认 MATLAB Runtime 安装文件夹：

平台MATLAB Runtime 安装文件夹
WindowsC:\Program Files\MATLAB\MATLAB Runtime\R2025b
Linux/usr/local/MATLAB/MATLAB_Runtime/R2025b
macOS/Applications/MATLAB/MATLAB_Runtime/R2025b

以非交互方式安装 MATLAB Runtime

支持的平台：Windows、Linux

如果要执行多个安装，则可以将安装参量指定为命令行参量或在安装程序控制文件中指定这些参量，以节省时间并防止错误。当您指定安装参量时，MATLAB Runtime 安装程序将作为后台任务运行，并且不会显示任何对话框。

以非交互方式运行时，安装程序会覆盖安装位置。

小心

在 Linux 上，安装程序会在产品配置说明对话框中显示设置环境变量所需的信息。如果以非交互方式使用安装程序，则必须找到 MATLAB Runtime 安装目录，以便在安装后设置库路径。有关详细信息，请参阅针对部署设置 MATLAB Runtime 路径。

以静默模式运行安装程序

要以静默模式安装 MATLAB Runtime，请执行以下操作：

  1. 将 MATLAB Runtime 安装程序存档的内容提取到临时文件夹。

  2. 在系统命令提示符下，导航到提取了安装程序的文件夹。

  3. 运行 MATLAB Runtime 安装程序，在命令行中指定 -agreeToLicense yes 选项。如果您没有将 -agreeToLicense yes 作为第一个选项，安装程序将不会安装 MATLAB Runtime。

    注意

    在大多数平台上，安装程序位于将存档提取到的文件夹的根目录下。在 64 位 Windows 上，安装程序位于存档 bin 文件夹中。

    平台命令
    Windowssetup -agreeToLicense yes
    Linux

    sudo ./install -agreeToLicense yes

    注意

    仅当安装到您没有写访问权限的目录时才需要 sudo。

    注意

    要安装 MATLAB Runtime R2022a 及更早版本，您还必须在命令中指定 -mode silent，才能以静默模式运行安装程序。

  4. 查看安装日志。

    • 在 Windows 系统上，安装程序会在 TEMP 环境变量定义的位置创建一个名为 mathworks_username.log 的日志文件，其中 username 是您的 Windows 登录名。

    • 在 Linux 上，安装程序在命令提示符下显示日志信息。如果您使用 -outputFile 选项，它还会将其保存到文件中。

自定义非交互式安装

以非交互方式运行时，安装程序将使用默认值，除非您另行指定。与 MATLAB 安装程序一样，MATLAB Runtime 安装程序接受多个修改默认安装属性的选项。

创建包含命令行选项和值的安装程序控制文本文件。省略每个选项前的连字符，并将每个选项和值对放在单独的行中。例如： 

agreeToLicense=yes
destinationFolder=/usr/MATLAB/MATLAB_Runtime
outputFile=myapp_log.txt

然后，使用 -inputfile 参量指定文件。例如，在 Linux 上：

./install -inputfile installer_input.txt

您可以在安装程序输入文件中指定以下选项。

选项描述
-agreeToLicense同意 MATLAB Runtime 许可证。
-destinationFolder指定 MATLAB Runtime 的安装位置。如果用户没有该文件夹的写访问权限，您必须以管理员权限运行安装程序。
-outputFile指定安装日志文件的写入位置。

注意

MATLAB 安装程序存档包含一个名为 installer_input.txt 的示例安装程序控制文件，其中包含可用于完整安装 MATLAB 的所有选项。但是，MATLAB Runtime 安装程序仅接受本部分列出的选项。

在无管理员权限的情况下安装 MATLAB Runtime

在 Linux 上，要在不使用 sudo 权限的情况下安装 MATLAB Runtime，请选择在安装过程中您有写访问权限的文件夹。

在 Windows 上，要在没有管理员权限的情况下以用户身份安装 MATLAB Runtime，请执行以下操作：

  1. 在您具有管理员权限的 Windows 计算机上安装 MATLAB Runtime。

  2. 将安装 MATLAB Runtime 的文件夹复制到您没有管理员权限的计算机。您可以将该文件夹压缩为 zip 文件以进行分发。

  3. 在没有管理员权限的计算机上，将 <MATLAB_RUNTIME_INSTALL_DIR>\runtime\arch 目录添加到用户的 PATH 环境变量中。有关详细信息，请参阅针对部署设置 MATLAB Runtime 路径。

在一台计算机上安装多个 MATLAB Runtime 版本

MCRInstaller 支持在目标计算机上安装多个版本的 MATLAB Runtime。此功能允许使用不同版本的 MATLAB Runtime 编译的应用程序在同一台计算机上并行执行。

如果您不希望目标计算机上安装多个 MATLAB Runtime 版本，则可以删除不需要的版本。在 Windows 上，从控制面板运行添加或删除程序来删除特定版本。在 Linux 上，手动删除不需要的 MATLAB Runtime 目录。您可以在安装较新版本的 MATLAB Runtime 之前或之后删除不需要的版本，因为这些版本可以按任何顺序安装或删除。

注意

macOS 不支持在同一台计算机上安装多个版本的 MATLAB Runtime。

同一台计算机上的 MATLAB 和 MATLAB Runtime

为了测试在开发计算机上部署的组件，您不需要安装 MATLAB Runtime。用于编译组件的 MATLAB 安装可以替代 MATLAB Runtime。

您可以安装 MATLAB Runtime 以用于调试目的。

修改路径

如果您在已有 MATLAB 的计算机上安装 MATLAB Runtime，则必须根据需要调整系统库路径。

要运行根据 MATLAB Runtime 而非 MATLAB 部署的 MATLAB 代码，请确保库路径将 MATLAB Runtime 目录列在任何 MATLAB 目录之前。有关设置环境变量的信息，请参阅针对部署设置 MATLAB Runtime 路径。

或者，您可以使用为编译的应用程序生成的 shell 脚本指定 MATLAB Runtime 的位置。

卸载 MATLAB Runtime

Windows

  1. 启动卸载程序。

    从 Windows 的“开始”菜单中，搜索添加或删除程序面板，然后双击列表中的 MATLAB Runtime。

    您也可以从 <MATLAB_RUNTIME_INSTALL_DIR>\bin\<arch> 文件夹启动 MATLAB Runtime 卸载程序，其中 <MATLAB_RUNTIME_INSTALL_DIR> 是您的 MATLAB Runtime 安装文件夹，<arch> 是特定于架构的文件夹，例如 win32 或 win64。

  2. 从“卸载产品”对话框的产品列表中选择 MATLAB Runtime，然后点击下一步。

  3. 点击完成。

Linux

  1. 关闭 MATLAB 和 MATLAB Runtime 的所有实例。

  2. 在 Linux 终端输入以下命令： 

    rm -rf <MATLAB_RUNTIME_INSTALL_DIR>

    小心

    使用 rm 命令时要小心，因为已删除的文件无法恢复。

macOS

  1. 关闭 MATLAB 和 MATLAB Runtime 的所有实例。

  2. 导航到您的 MATLAB Runtime 安装文件夹。例如，安装文件夹可能在您的应用程序文件夹中被命名为 MATLAB_Compiler_Runtime.app。

  3. 将 MATLAB Runtime 安装文件夹拖到垃圾桶，然后从 Finder 菜单中选择清空垃圾桶。

另请参阅

主题