在永久离线的计算机上安装文档

自 R2023a 起

默认情况下，在使用 MATLAB® 时，您可以访问 Web 上的产品文档。要在永久离线的计算机上使用文档，您可以下载文档，将其复制到离线计算机上，并将其安装在该计算机上。

如果您通常在连接到 Internet 的情况下使用 MATLAB，只是偶尔会离线工作，请参阅安装文档以供临时离线使用。

前提条件

  • 在此过程中，您需要下载文档 ISO（Windows® 和 Linux®）或 DMG (macOS) 镜像并将其装载到离线计算机。建议您了解一些 IT 概念，但这不是必需的。

  • 用于下载文档的计算机必须连接到 Internet。

  • 要下载文档，您必须有 MathWorks® 帐户。在离线计算机上安装文档不需要具有 MathWorks 帐户。

  • 用于下载文档的计算机和离线计算机都必须有 10 GB 以上的可用磁盘空间来容纳文档 ISO 或 DMG 镜像的大小。

  • 离线计算机上必须已安装 MATLAB。

下载文档（需要 Internet 连接）

要下载 R2025b 文档，请在以下操作系统列表中，选择目标离线计算机的操作系统。然后，点击下载文档。

要下载 R2025b 之前版本的文档，请参阅支持文章如何下载文档并将其安装在离线计算机上？

将文档复制到离线计算机

使用可移动媒体或共享网络位置将下载的文档 ISO 或 DMG 镜像复制到离线计算机上。然后，在离线计算机上，使用适用于您的平台的标准过程装载文档 ISO 或 DMG 镜像。

有关更多详细信息，请参阅支持文章如何使用 ISO 或 DMG 镜像安装 MathWorks 产品？

在离线计算机上安装文档

使用 mpm 命令行工具在离线计算机上安装文档。mpm 包含在下载的文档 ISO 或 DMG 镜像中。

注意

针对您的操作系统从命令行执行下列步骤。不要从 MATLAB 运行这些命令。

  1. 在操作系统命令行下，导航到包含文档安装程序的已装载镜像中的文件夹。

    cd <mountedDocImage>/bin/<arch>

    • <mountedDocImage> 是装载的文档 ISO 或 DMG 镜像的根目录。

    • <arch> 是 ISO 或 DMG 镜像的操作系统架构文件夹，例如 win64、glnxa64、maci64 或 maca64。

  2. 使用 mpm install-doc 命令安装文档。将 --matlabroot 选项指定到离线计算机上安装 MATLAB 的文件夹。默认情况下，mpm 会将文档安装到 MATLAB 内的支持包根文件夹中，该支持包根文件夹由函数 matlabshared.supportpkg.getSupportPackageRoot 确定。

    Windows 示例：

    .\mpm.exe install-doc --matlabroot="C:\Program Files\MATLAB\R2025b"

    Linux 或 Mac 示例：

    ./mpm install-doc --matlabroot=/home/<username>/matlab

    要将文档安装到自定义位置，还需要使用 --destination 选项指定此位置的完整路径。如果您要执行以下操作，请使用此选项：

    • 将文档安装在网络驱动器上以便所有用户都访问相同的版本。

    • 将文档安装到可供多个用户访问的计算机上的共享位置。这种情况仅适用于 Linux 和 Mac 平台，在这些平台上，文档将默认安装到用户特定的文件夹。在 Windows 上，文档将默认安装到共享位置。

    Windows 示例：

    .\mpm.exe install-doc --matlabroot="C:\Program Files\MATLAB\R2025b" --destination="Z:\Shared\MATLAB Doc"

    Linux 或 Mac 示例：

    ./mpm install-doc --matlabroot=/home/<username>/matlab --destination=/usr/local/share/matlab-doc

  3. 卸载文档 ISO 或 DMG 镜像。如果需要回收磁盘空间，请删除该镜像。

配置 MATLAB 以使用安装的文档

更新 MATLAB 设置，以便 MATLAB 打开安装的文档而不是 Web 文档。对于每个要使用文档的 MATLAB 安装，请执行以下操作：

  1. 打开 MATLAB，然后在命令提示符下输入：

    s=settings, s.matlab.help.DocLocation.PersonalValue='INSTALLED';

  2. 如果您已将文档安装到自定义位置，请更新文档根目录，以将 MATLAB 指向该位置。<custom/doc/install/folder> 是您在 mpm install-doc 的 --destination 选项中指定的文档路径。

    docroot('<custom/doc/install/folder>/help')

  3. （可选）将上述 MATLAB 命令添加到 startup.m 或 matlabrc.m 文件，以便它们在每次 MATLAB 启动时都运行。有关使用 MATLAB 启动文件的更多详细信息，请参阅在 MATLAB 启动文件中指定启动选项。

  4. 重新启动 MATLAB。

验证本地安装

验证文档是否在本地打开。在 MATLAB 命令提示符下，输入：doc

在打开的浏览器页面中，检查 URL 的地址。

  • 如果 URL 指向本地 IP 地址和端口号（例如 http://127.0.0.1:12345），则 MATLAB 访问的是本地安装的文档。

  • 如果 URL 指向 Web 地址（例如 https://www.mathworks.com/help/...），则 MATLAB 访问的仍然是 Web 文档。更新 MATLAB 以指向本地安装的文档，如配置 MATLAB 以使用安装的文档节中所述。

在离线计算机上更新文档

要在添加或删除产品后更新已安装的文档，或要安装最新文档，请重复上述过程。

另请参阅

主题