检查 MISRA C:2004 (-misra2)
（即将删除）检查违反 MISRA C:2004 规则的情形
以后的版本中将会删除检查违反 MISRA™ C:2004 的情形。改用标准 MISRA C:2023。 (自 R2024b 起)。有关信息，请参阅版本历史记录。
描述
指定是否检查违反 MISRA C™:2004 规则的情形1 .此选项的每个值对应一个要检查的规则子集。
设置选项
使用以下方法之一设置选项：
Polyspace® 用户界面（仅限桌面端产品）：在您的工程配置中，选择编码标准和代码度量节点，然后为此选项选择一个值。有关您必须先启用的其他选项，请参阅依赖关系。
Polyspace 平台用户界面（仅限桌面端产品）：工程配置中不存在此选项。通过
使用自定义检查项文件和检查项激活文件 (-checkers-activation-file)选项激活检查项。
为何使用此选项
使用此选项指定要检查的 MISRA C:2004 规则子集。
分析完成后，结果列表窗格中会列出检测到的编码标准违规。在源窗格中，对于每项编码违规，Polyspace 都会为与该违规相关的关键字或标识符显示一个 
符号。
设置
默认值：required-rules
- required-rules
检查必需编码规则。
- single-unit-rules
检查仅适用于单个转换单元的规则子集。这些规则在分析的编译阶段进行检查。
- system-decidable-rules
检查
single-unit-rules子集中的规则，以及适用于程序文件集合的某些规则。这些附加规则是在集成级别应用的复杂度较低的规则。由于这些规则涉及多个转换单元，因而只能在集成层面进行检查。这些规则会在分析的编译和链接阶段进行检查。- all-rules
检查必需和建议编码规则。
- SQO-subset1
仅检查 MISRA C 规则的子集。
- SQO-subset2
检查规则的子集，包括 SQO-subset1 以及某些附加规则。
- from-file
指定一个 XML 文件，您可以在其中针对此编码标准配置自定义检查项选择。要创建配置文件，请点击
，然后从检查项选择窗口的右侧窗格中，选择此编码标准中要检查的规则和建议。保存该文件。 要使用或更新某个现有配置文件，请在检查项选择窗口中，在提供的字段中输入该文件的完整路径，或者点击浏览。
如果您将选项设置为 from-file，请启用
使用文件设置检查项 (-checkers-selection-file)。
依赖关系
仅在您将
源代码语言 (-lang)设置为 C 或 C-CPP 时，此选项才可用。对于具有混合 C 和 C++ 代码的工程，MISRA C:2004 检查项仅分析
.c文件。如果您将
源代码语言 (-lang)设置为 C-CPP，则可以激活 C 编码规则检查项和 C++ 编码规则检查项。如果您同时激活 C 和 C++ 编码规则检查项，为避免出现重复结果，Polyspace 不会生成在链接阶段中发现的 C 编码规则（例如 MISRA C:2012 规则 8.3）。
提示
如果您选择 single-unit-rules 或 system-decidable-rules 选项，并且选择仅检测编码违规，则相较于检查其他规则，分析可以更快完成。有关详细信息，请参阅Coding Rule Subsets Checked Early in Analysis。
命令行信息
在命令行中使用 -misra2 命令检查是否存在违反 MISRA C:2004 规则的情形。
参数：-misra2 |
值：required-rules | all-rules | SQO-subset1 | SQO-subset2 | single-unit-rules | system-decidable-rules | from-file |
示例 (Bug Finder)：polyspace-bug-finder -sources |
示例 (Bug Finder Server)：polyspace-bug-finder-server -sources |
或者，通过检查项激活 XML 文件启用所有或特定 MISRA C:2004 规则。请参阅检查项激活文件 (-checkers-activation-file)。
版本历史记录
从 R2019a 开始，用来自定义编码标准检查项选择的文件必须使用 XML 格式。为此目的使用文本文件会导致错误。您可以将 Polyspace 支持的所有编码标准的自定义选择保存到同一文件中。
桌面端界面：
如果您的工程包含采用文本格式的自定义编码标准选择文件，则 Polyspace 会自动更新这些文件并将其合并为单个 XML 文件。如果您的工程具有引用同一自定义选择文件的多个冲突配置，则该软件会将每个配置的合并编码标准选择保存到单独的 XML 文件中。
要手动将您的文本文件更新为 XML 格式，请在配置窗格的编码标准和代码度量节点中点击 
。在检查项选择窗口中，选择相应的文件并点击保存更改。Polyspace 会将这些文件合并为单个 XML 文件，并将此文件保存为 filename.xmlfilename 是按字母顺序排列的第一个选定文件的名称。例如，如果您选择 foo.conf 和 bar.conf，则它们将被保存为 bar.conf.xml。
命令行/ IDE：
在命令行或 IDE 扩展中，使用文本文件作为 -misra2 的输入会导致错误。要选择 MISRA C:2004 规则的自定义选择，请使用 XML 文件。
使用 misra_c_2004_rules.xml 文件作为模板来创建 XML 文件，在其中定义编码标准检查项的自定义选择。此模板文件位于 polyspaceroot\polyspace\examples\doc_cxx\coding_standards_XMLpolyspacerootC:\Program Files\Polyspace\R2025a。要更新您的脚本，请参阅下表：
| 选项 | 改用 |
|---|---|
-misra2 "custom_standard.conf" | -checkers-selection-file misra_c_2004_rules.xml -misra2 from-file |
请参阅：
注意
在以后的版本中，检查项配置文件的 XML 格式可能会有所变化。
1 MISRA and MISRA C are registered trademarks of MIRA Ltd., held on behalf of the MISRA Consortium.
