Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

MATLAB 代码兼容性分析器

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

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

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

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

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

打开代码兼容性分析器

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

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

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

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

    Code Compatibility Analyzer App

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

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

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

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

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

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

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

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

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

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

编程用法

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

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

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

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

不支持的功能

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

另请参阅

| | |