Main Content

本页的翻译已过时。点击此处可查看最新英文版本。

visdiff

比较两个文件或文件夹

全页折叠

语法

visdiff(name1,name2)
visdiff(name1,name2,type)
comparison=visdiff(___)

说明

示例

visdiff(name1,name2) 在比较工具中显示两个指定的文件或文件夹之间的差别。文件比较工具支持许多文件类型，例如 MATLAB® 代码文件、zip 文件、MAT 文件以及各种其他 MATLAB 和 Simulink® 文件格式。

使用 visdiff 比较两个 Simulink 模型，并标识模型之间的更改或合并差别。有关详细信息，请参阅模型比较 (Simulink)。

示例

visdiff(name1,name2,type) 使用指定的比较类型比较两个文件或文件夹。如果未指定类型，visdiff 将使用适合选定文件的默认比较类型。比较文件夹时，type 选项不适用。

示例

comparison=visdiff(___) 比较两个模型文件，并返回包含两个文件差别的比较对象。此语法不会打开比较工具，且只能用于比较 Simulink 模型。name1 和 name2 必须是模型文件。可以使用比较对象在命令行中控制比较，例如，通过应用筛选器和发布比较报告来进行控制。

示例

全部折叠

打开实时脚本

使用相对路径和完整路径比较两个文件。

比较当前文件夹中的两个文件 lengthofline.m 和 lengthofline2.m 。

visdiff('lengthofline.m','lengthofline2.m')

使用完全限定的文件名比较两个演示文件 gatlin.mat 和 gatlin2.mat。

visdiff(fullfile(matlabroot,'toolbox','matlab','demos','gatlin.mat'), ...
fullfile(matlabroot,'toolbox','matlab','demos','gatlin2.mat'))
打开实时脚本

将 lengthofline.m 和 lengthofline2.m 两个文件作为二进制文件进行比较。

如果不指定类型，visdiff 将使用默认的文本比较类型来比例这两个文件。通过更改为二进制文件比较类型，可以检查行尾字符之类的差别。 

visdiff('lengthofline.m','lengthofline2.m','binary')

比较 Simulink 模型时，可以为 visdiff 指定输出参数，以便以命令行方式来操作比较结果。

比较两个模型文件，并从 visdiff 获取比较对象输出。

comparison = visdiff(modelname1, modelname2);

（可选）筛选比较结果。支持的筛选选项包括：'unfiltered' - 从比较中删除所有筛选策略，'default' - 默认的比较筛选策略。

filter(comparison, 'unfiltered');

要将比较报告发布为文件，请对比较对象使用 publish。发布的报告的默认格式为 HTML。publish 将文件保存在当前文件夹中，如 filename1_filename2.html。

file = publish(comparison);
web(file)

要指定报告选项，请在 publish 中使用以下名称-值对组。

  • 'Format' - 发布的报告的文件格式。

    选项包括：'html'（默认值）- 单一 HTML 文档，'docx' - Microsoft® Word 文档，或 'pdf' – PDF document。

  • 'Name' - 报告的名称。

    字符向量或标量字符串数组。如果指定了文件扩展名，将忽略 'Format'。

  • 'OutputFolder' - 保存报告的位置。

    字符向量或标量字符串数组。默认位置为当前文件夹。

也可以在 options 结构体中指定名称-值对组：publish(comparison, options)。

输入参数

全部折叠

要比较的文件或文件夹的名称，指定为字符向量。name 可以包含相对路径，但相对路径必须在当前文件夹中。否则，name 必须包括完整路径。

比较类型，指定为 'text'、'binary' 或 'xml'。某些比较并非所有的比较类型都支持。如果指定了不支持的比较类型，MATLAB 将显示错误。

要检查文本文件的差别，如行尾字符的差别，请指定 'binary' 比较类型。

XML 文件的默认比较类型取决于 XML 类型，可以是 'text' 或 'xml'。指定 'text' 或 'xml' 将覆盖文件的默认比较类型。

输出参数

全部折叠

比较对象，用于以命令行方式对比较结果进行操作，例如，可以应用筛选选项和发布比较报告。只能用于比较 Simulink 模型。

局限性

MATLAB Online™ 仅支持比较文本文件、MATLAB 代码文件和 Simulink 模型。当前不支持其他文件类型，如 zip 文件和 MAT 文件。

提示

在某些情况下，您选择的内容可能会有多种适用的比较类型（例如，文本、二进制、文件列表或 XML 比较）。要选择不同的比较类型，请使用 visdiff 函数并指定 type 参数。您还可以从比较工具的可用比较类型中进行选择。有关详细信息，请参阅比较文件和文件夹以及合并文件。

替代功能

作为 visdiff 函数的替代方法，还可以使用比较工具以交互方式比较文件或文件夹。要打开比较工具，请转到主页选项卡，在文件部分点击比较。然后选择要比较的文件或文件夹。

您还可以比较编辑器中打开的文件。在编辑器或实时编辑器选项卡上，从文件部分选择比较。

要将文件的自动保存版本与磁盘上保存的版本进行比较，请转到编辑器选项卡并点击比较 ，然后选择与磁盘上的版本进行比较或保存并与自动保存版本进行比较。如果您的文件已修改，编辑器会在比较之前保存该文件。与磁盘上的版本进行比较和保存并与自动保存进行比较选项仅在自动保存文件更改的选项禁用时可用。要禁用该选项，请转到主页选项卡，然后在环境部分中点击预设。然后，选择编辑器/调试器，并清除在文件外点击时保存更改。

要比较当前文件夹浏览器中的文件或文件夹，请右键点击选定的文件或文件夹，然后选择比较对象。要比较两个文件或子文件夹，请右键点击选定的文件或文件夹，然后选择比较选定的文件/文件夹。

版本历史记录

在 R2008b 中推出

另请参阅

主题