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

自 R2023a 起

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

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

前提条件

在此过程中，您需要下载文档 ISO（Windows^® 和 Linux^®）或 DMG (macOS) 镜像并将其装载到离线计算机。建议您了解一些 IT 概念，但这不是必需的。
用于下载文档的计算机必须连接到 Internet。
要下载文档，您必须有 MathWorks^® 帐户。在离线计算机上安装文档不需要具有 MathWorks 帐户。
用于下载文档的计算机和离线计算机都必须有 10 GB 以上的可用磁盘空间来容纳文档 ISO 或 DMG 镜像的大小。
离线计算机上必须已安装 MATLAB。

下载文档（需要 Internet 连接）

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

登录以下载文档

要下载其他版本的文档，请按照以下步骤操作：

从 MathWorks 下载的选择版本列表中，选择要下载的版本。
从我要列表中，选择获取 ISO 和 DMG。
展开获取 MATLAB 和 Simulink 产品文档。
点击了解更多链接以打开下载和安装所选版本文档的说明。按照对应页（而不是此页）上的说明进行操作。

将文档复制到离线计算机

使用可移动媒体或共享网络位置将下载的文档 ISO 或 DMG 镜像复制到离线计算机上。然后，在离线计算机上，使用适用于您的平台的标准过程装载文档 ISO 或 DMG 镜像。有关更多详细信息，请参阅如何使用 ISO 或 DMG 镜像安装 MathWorks 产品？

在离线计算机上安装文档

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

注意

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

在操作系统命令行下，导航到包含文档安装程序的已装载镜像中的文件夹。
```
cd mountedDocImage/bin/arch
```
- mountedDocImage 是装载的文档 ISO 或 DMG 镜像的根目录。
- arch 是 ISO 或 DMG 镜像的操作系统架构文件夹，例如 win64、glnxa64、maci64 或 maca64。
使用 mpm install-doc 命令运行文档安装程序。指定 --matlabroot 选项以设置离线计算机上安装的 MATLAB 所在的文件夹。
Windows
语法：
```
.\mpm install-doc --matlabroot=matlabroot
```
示例：
```
.\mpm install-doc --matlabroot="C:\Program Files\MATLAB\R2024a"
```
如果 matlabrootfolder 路径包含空格，请用双引号将路径引起来，如以上示例中所示。
Linux 或 macOS
语法：
```
./mpm install-doc --matlabroot=matlabrootfolder
```
示例：
```
./mpm install-doc --matlabroot=/home/username/matlab
```
默认情况下，mpm 会将文档安装到 MATLAB 内的支持包根文件夹中。要查找支持包根目录，请使用函数 matlabshared.supportpkg.getSupportPackageRoot。
要为文档指定不同位置，请使用 --destination 选项。如果将文档 ISO 或 DMG 镜像安装在不同于 MATLAB 安装所在的位置，例如网络驱动器，请使用 --source 选项提供安装程序文件的完整路径。
Windows
```
.\mpm install-doc --matlabroot=matlabrootfolder --source=docinstallfolder --destination=destinationfolder
```
Linux 或 macOS
```
./mpm install-doc --matlabroot=matlabrootfolder --source=docinstallfolder --destination=destinationfolder
```
注意
如果安装期间出现错误 Conflicting release versions，请验证文档 ISO 或 DMG 镜像对应的版本与离线计算机上安装的 MATLAB 软件的版本是否相同。版本名称包含在 ISO 或 DMG 镜像的文件名中。
卸载文档 ISO 或 DMG 镜像。如果需要回收磁盘空间，请删除该镜像。

配置 MATLAB 以使用安装的文档

更新 MATLAB 预设项，以便 MATLAB 打开安装的文档而不是 Web 文档。

打开 MATLAB。
在主页选项卡的环境部分中，点击预设项。
在“预设项”对话框的左窗格中，点击 MATLAB，然后点击帮助。
在文档位置下，选择本地。
仅当您使用 --destination 标志将文档安装在默认位置以外的其他位置时，才需要执行此步骤。
更新文档根目录，使 MATLAB 指向文档的安装位置。
1. 打开 MATLAB startup.m 文件。如果此文件不存在，请用此名称创建一个空白文件。此文件中指定的命令在 MATLAB 启动时运行。有关 startup.m 文件的更多详细信息，请参阅在 MATLAB 启动文件中指定启动选项。
2. 在 startup.m 文件中，添加以下行以将文档根目录设置为新文档位置。newDocInstallFolder 是安装文档的文件夹的路径。
  docroot('newDocInstallFolder/help')
3. 重新启动 MATLAB。

验证本地安装

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

如果文档主页打开，请将光标放在打开的页面中的链接之一上，并检查左下角显示的 URL 的格式。如果 URL 是本地文件路径（例如，file:///C:/ProgramData/MATLAB/...），则 MATLAB 将打开本地文档。
如果打开空白页，或如果文档主页 URL 显示 Web 路径（例如，https://www.mathworks.com/help/...），则 MATLAB 仍会打开 Web 文档。更新 MATLAB 以指向本地安装的文档，如配置 MATLAB 以使用安装的文档中所述。

在离线计算机上更新文档

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