CMAKE_EXPORT_SARIF

4.0 版本新增。

为项目启用或禁用 CMake 诊断输出（SARIF 格式）。

如果启用，CMake 将在运行项目时生成一个 SARIF 日志文件，其中包含 CMake 输出的诊断消息。默认情况下，日志文件写入到 .cmake/sarif/cmake.sarif，但可以通过设置命令行选项 cmake --sarif-output 为所需路径来更改位置。

静态分析结果交换格式 (SARIF) 是一种基于 JSON 的标准格式，用于静态分析工具（包括 CMake 等构建工具）记录和传达诊断消息。CMake 会为运行 CMake 时产生的警告和错误生成 SARIF 日志条目（例如 message() 调用）。每个日志条目都包含消息、严重性以及可用时的位置信息。

CMake 的 SARIF 输出示例为

{
  "version" : "2.1.0",
  "$schema" : "https://schemastore.azurewebsites.net/schemas/json/sarif-2.1.0-rtm.4.json",
  "runs" :
  [
    {
      "tool" :
      {
        "driver" :
        {
          "name" : "CMake",
          "rules" :
          [
            {
              "id" : "CMake.Warning",
              "messageStrings" :
              {
                "default" :
                {
                  "text" : "CMake Warning: {0}"
                }
              },
              "name" : "CMake Warning"
            }
          ]
        }
      },
      "results" :
      [
        {
          "level" : "warning",
          "locations" :
          [
            {
              "physicalLocation" :
              {
                "artifactLocation" :
                {
                  "uri" : "/home/user/development/project/CMakeLists.txt"
                },
                "region" :
                {
                  "startLine" : 5
                }
              }
            }
          ],
          "message" :
          {
            "text" : "An example warning"
          },
          "ruleId" : "CMake.Warning",
          "ruleIndex" : 0
        }
      ]
    }
  ]
}