Main Content

MATLAB 代码兼容性分析器

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

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

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

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

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

由 MATLAB 代码分析器执行的所有检查的列表,包括兼容性问题,在此处提供:Index of Code Analyzer Checks

打开代码兼容性分析器

要运行代码兼容性分析器,请执行下列操作:

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

  2. 在命令提示符下运行 codeCompatibilityReport 来生成报告,或从 App 选项卡中选择代码兼容性分析器Icon of Code Compatibility App

    该报告显示潜在兼容性问题。例如:

    Code Compatibility Analyzer App

  3. 更新代码以解决语法错误部分列出的每个文件中的语法错误。语法错误会导致代码不能运行。虽然代码在以前的版本中很可能运行不正常,但是语法错误会影响兼容性分析。例如,'(' 可能缺少结束的 ')',导致行(1)的行尾的语法无效。

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

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

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

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

    • 可能导致错误的不受支持的功能 - 此处列出的文件使用的功能不受支持、尚未公开且不适合客户使用。请更新您的代码以使用公开的功能来避免错误和意外的行为变化。

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

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

    • 可能改进代码的新功能 - 考虑更新您的代码。预计当前代码将在以后的版本中继续正常运行,但推荐使用更新功能。

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

编程用法

要以编程方式生成报告,请使用以下方法之一。

  • 要以编程方式生成在 MATLAB® Web 浏览器中打开的报告,请使用 codeCompatibilityAnalyzer 并指定您要分析的文件夹。

  • 要为当前文件夹及其子文件夹生成报告,请使用 codeCompatibilityReport 函数。

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

不支持的功能

代码兼容性分析器检查不受支持、尚未公开且不适合使用的功能。此类功能可能在不提前通知的情况下被更改或删除,并可能导致将来出现错误。在某些情况下,有公开的替代功能,但可能不是简单的替代。请联系 MathWorks 支持部门,说明您的用法并查询受支持的替代功能。

另请参阅

| | |