在永久离线的计算机上安装文档
默认情况下,在使用 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 运行这些命令。
在操作系统命令行下,导航到包含文档安装程序的已装载镜像中的文件夹。
cd <mountedDocImage>/bin/<arch>
<mountedDocImage>
是装载的文档 ISO 或 DMG 镜像的根目录。<arch>
是 ISO 或 DMG 镜像的操作系统架构文件夹,例如win64
、glnxa64
、maci64
或maca64
。
使用
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
卸载文档 ISO 或 DMG 镜像。如果需要回收磁盘空间,请删除该镜像。
配置 MATLAB 以使用安装的文档
更新 MATLAB 设置,以便 MATLAB 打开安装的文档而不是 Web 文档。对于每个要使用文档的 MATLAB 安装,请执行以下操作:
打开 MATLAB,然后在命令提示符下输入:
s=settings, s.matlab.help.DocLocation.PersonalValue='INSTALLED';
如果您已将文档安装到自定义位置,请更新文档根目录,以将 MATLAB 指向该位置。
<custom/doc/install/folder>
是您在mpm install-doc
的--destination
选项中指定的文档路径。docroot('<custom/doc/install/folder>/help')
(可选)将上述 MATLAB 命令添加到
startup.m
或matlabrc.m
文件,以便它们在每次 MATLAB 启动时都运行。有关使用 MATLAB 启动文件的更多详细信息,请参阅在 MATLAB 启动文件中指定启动选项。重新启动 MATLAB。
验证本地安装
验证文档是否在本地打开。在 MATLAB 命令提示符下,输入:doc
在打开的浏览器页面中,检查 URL 的地址。
如果 URL 指向本地 IP 地址和端口号(例如
http://127.0.0.1:12345
),则 MATLAB 访问的是本地安装的文档。如果 URL 指向 Web 地址(例如
https://www.mathworks.com/help/...
),则 MATLAB 访问的仍然是 Web 文档。更新 MATLAB 以指向本地安装的文档,如配置 MATLAB 以使用安装的文档节中所述。
在离线计算机上更新文档
要在添加或删除产品后更新已安装的文档,或要安装最新文档,请重复上述过程。