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

自 R2023a 起

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

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

前提条件

  • 离线计算机必须运行在 Linux® 或 Windows® 上。在 macOS 操作系统上，不支持从装载的 DMG 镜像下载和安装文档。

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

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

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

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

  • 建议您了解一些 IT 概念，但这不是必需的。

下载文档（需要 Internet 连接）

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

注意

macOS DMG 不可用。要在 macOS 操作系统上下载和安装文档，请参阅安装文档以供临时离线使用。

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

将文档复制到离线计算机

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

有关详细信息，请参阅相应的支持文章。

在离线计算机上安装文档

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

注意

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

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

    cd <mountedDocImage>/bin/<arch>

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

    • <arch> 是 ISO 镜像的操作系统架构文件夹，例如 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 平台，在该平台上，文档将默认安装到用户特定的文件夹。在 Windows 上，文档将默认安装到共享位置。

    Windows 示例：

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

    Linux 示例：

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

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

配置 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 以使用安装的文档节中所述。

在离线计算机上更新文档

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

另请参阅

主题