Main Content

本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

MATLAB 代码兼容性报告

代码兼容性报告是方便的工具,它可以分析您的代码,以表形式列出所有兼容性问题,并为您提供如何解决这些兼容性问题的说明。该报告使您能够:

  • 确定在当前 MATLAB® 版本中,代码要正常运行必须解决的兼容性问题。

  • 估计当您升级到更新 MATLAB 版本时更新代码所需的工作量。

  • 通过替换不推荐使用的功能以改进您的代码。

代码兼容性报告显示受兼容性问题影响的代码位置,并提供文档链接,以帮助获取有关如何在每个位置进行必要更改的详细信息。

生成代码兼容性报告

要运行代码兼容性报告,请执行下列操作:

  1. 在当前文件夹浏览器中,导航到并打开包含您要分析的代码文件的文件夹。

  2. 在列出您要分析的文件的当前文件夹浏览器中,点击 或在浏览器的空白处右键点击。这两个选项都会打开一个菜单。选择报告 > 代码兼容性报告。您也可以在命令提示符下运行 codeCompatibilityReport 来生成报告。

    报告将显示在 MATLAB Web 浏览器中,指出潜在的兼容性问题。例如:

  3. 更新代码以解决语法错误部分列出的每个文件中的语法错误。语法错误会导致代码不能运行。虽然代码在以前的版本中很可能运行不正常,但是语法错误会影响兼容性分析。例如,在 '}' 处出现解析错误:使用的 MATLAB 语法可能无效。

  4. 对于报告中列出的每项功能,请认真查看问题描述和您的代码。消息包含行号,可帮助您在代码中定位问题。要在编辑器中打开文件并定位到该行,请点击行号。然后根据消息更改文件。如果您不能确定某条消息的含义或要更改代码中的哪些内容,请点击与消息对应的文档链接。

    报告中列出的每项功能都会显示建议的操作。您也可以遵循以下一般性建议:

    • 已经删除的功能 - 更新您的代码以避免当前版本中的兼容性错误。

    • 行为已经改变的功能 - 确认行为的更改是可接受的,如果不可接受,请针对当前版本更新您的代码。

    • 将要删除的功能 - 现在更新您的代码,也可在以后的版本中更新。现在更新您的代码会使将来的升级更加容易。

    • 行为将要改变的功能 - 立即调查这些变化,以便将来的升级更容易。

    • 不建议使用的功能 - 考虑更新您的代码。预计代码将在以后的版本中继续正常运行,但其中使用了不推荐的功能。

    代码兼容性报告还包含有关对您的代码执行的检查的信息,以及进行了 MATLAB 代码兼容性分析的文件列表。

编程用法

当您通过当前文件夹浏览器生成代码兼容性报告时,MATLAB 会分析当前工作文件夹及其子文件夹中的代码。但是,如果以编程方式生成报告,则可以指定要分析的具体文件或从分析中排除子文件夹。要以编程方式生成报告,请使用以下方法之一。

  • 要以编程方式生成在 MATLAB® Web 浏览器中打开的报告,请使用 codeCompatibilityReport 函数。

  • 要返回包含报告信息的 CodeCompatibilityAnalysis 对象,请使用 analyzeCodeCompatibility 函数。然后,您可以使用 codeCompatibilityReport 函数显示所存储对象的报告。

另请参阅

| |