主要内容

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

自 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 镜像的操作系统架构文件夹,例如 win64glnxa64maci64maca64

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

在离线计算机上更新文档

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

另请参阅

主题