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

MATLAB 代码分析器报告

运行代码分析器报告

代码分析器报告通过消息显示代码中的潜在错误和问题以及改进机会。例如,一则常见消息会指明可能未使用变量 foo

要运行代码分析器报告,请执行以下操作:

  1. 在当前文件夹浏览器中,导航到包含您要检查的文件的文件夹。

    要使用本文档中显示的 lengthofline.m 示例,请将文件保存到当前文件夹或您具有写入访问权限的文件夹中。以下示例将文件保存到当前文件夹 C:\my_MATLAB_files

    copyfile(fullfile(matlabroot,'help','techdoc','matlab_env','examples','lengthofline.m'))
  2. 在当前文件夹浏览器中,点击 ,然后选择报告 > 代码分析器报告

    报告显示在 MATLAB® Web 浏览器中,其中显示了已确定存在潜在问题或改进机会的文件。

  3. 针对报告中的每则消息,查看相关建议及对应的代码。点击行号,即可在编辑器中将文件打开到该行,然后根据消息来更改文件。请遵循以下一般性建议:

    • 如果您不确定某则消息的含义或要在代码中更改的内容,请点击该消息中的链接(如果显示有链接)。有关详细信息,请参阅检查代码中的错误和警告

    • 如果消息中不含链接,并且您不确定某则消息的含义或需要采取的操作,请在帮助浏览器中搜索相关主题。有关消息以及如何处理它们的示例(包括对示例 lengthofline.m 所做的特定更改),请参阅根据代码分析器消息更改代码

    • 这些消息并不提供适合每种情形的信息,在某些情况下,您可能不需要根据消息更改任何内容。有关详细信息,请参阅了解代码分析的局限

    • 如果您不希望看到某些消息或某些类型的消息,可以将其隐蔽起来。有关详细信息,请参阅调整代码分析器消息指示标记和消息

  4. 修改该文件后,请将它保存。如果您进行了大量更改,可能会带来错误,请考虑以不同的名称来保存该文件。随后,您可以根据需要参考原始文件来解决已更新文件中的问题。使用编辑器实时编辑器选项卡上的 比较按钮有助于标识您对文件所做的更改。有关详细信息,请参阅比较和合并文本

  5. 再次运行并调试文件以确保您没有不经意地引入任何错误。

  6. 如果正在显示报告,点击重新运行此报告可根据您对文件所做的更改来更新报告。根据您对文件所做的更改,确保这些消息不复存在。要在 MATLAB Online™ 中返回报告,请在当前文件夹浏览器中点击 ,然后选择报告 > 代码分析器报告

根据代码分析器消息更改代码

要了解有关如何更正代码分析器消息中指出的潜在问题的信息,请使用以下资源:

  • 在编辑器中打开文件,并点击工具提示中的详细信息按钮,如本列表随后的图像所示。此时将打开扩充的消息。但是,并非所有消息都具有扩充的消息。

  • 使用帮助浏览器的搜索窗格可查找有关消息中提到的术语的文档。

下图显示了带详细信息按钮的工具提示。等号 (=) 下边的橙色线条指明当您将鼠标指针悬停于等号上时会显示工具提示。橙色的高亮显示方式指示可以使用自动修复。

访问代码分析器消息的其他方法

使用下列任一方法均可获取代码分析器消息。每种方法都提供相同的消息,但采用的格式不同:

  • 通过探查器详细信息报告来访问某文件的代码分析器报告。

  • 运行 checkcode 函数,以便分析指定的文件并在命令行窗口中显示消息。

  • 运行 mlintrpt 函数,以便运行 checkcode 并在 Web 浏览器中显示消息。

  • 在编辑器中处理文件时使用代码的自动检查功能。请参阅 在编辑器中自动检查代码 - 代码分析器