在C、C++项目刚开始接入静态分析的时候，常常会碰到编译数据库要怎么去配置，还有往QAC里导入这个数据库万一失败了，又该怎么去修正的问题，QAC这个工具，它并不是只把源文件拿过来简简单单地扫一遍就完事了，它还需要知道，每一个源文件在当时，到底是怎么被编译出来的，这中间就包括了用的是哪一种编译器、头文件都从哪些路径去找、都定义了哪些宏、工作目录是在哪里，还有编译的时候都加了哪些选项，Helix QAC是支持通过命令行的方式，去用一个JSON格式的编译数据库，来把项目给同步起来的，这里面，那个最典型的文件，就是记录了编译命令的那个JSON文件。
一、编译数据库要怎么配置
在动手去给QAC配置编译数据库之前，要先保证一件事，就是你的项目它自己，是能够被正常地构建出来的，那个编译数据库，它做的事情，只不过是把真实跑过的构建命令给记录下来，要是原来的工程，本身就缺了头文件、缺了宏的定义，或者是工具链没配好，那这些东西被导进QAC以后，也还是会照样报错的。
1、要先去把那个记录编译命令的文件给生成出来
要是你的项目用的是CMake，那就可以在生成构建目录的那个时候，去把导出编译数据库的选项给打开；要是用的是Makefile、脚本构建，或者是交叉编译的那套环境，那就可以靠那种能拦截构建过程的工具去把它给生成出来，这个文件里面的内容，通常是要包含着目录、源文件的名字，还有编译命令，这些个字段的，用来讲明白，某一个源文件它到底是在哪个目录底下，又是被用什么样的命令给编译出来的，按照Clang那套编译数据库的规范，每一个命令对象，它都是对应着一个翻译单元的。
2、去检查一下，那些路径是不是都能访问得到
把那个JSON文件，给放到构建目录，或者是项目约定好的那个目录里面去以后，先拿一个文本编辑器把它给打开，去检查一下，那里面的文件路径、包含路径，还有编译器的路径，在你当前跑QAC的这台机器上，是不是都真实地存在着，特别是那种，从Linux的构建机上，把文件复制到了Windows的电脑上以后，那个路径的格式，是经常会失效的。
3、用命令行工具去把项目给同步一下
在进到命令行里面以后，去把QAC项目的目录，还有那个JSON文件的路径，都给指定好，然后去执行一下同步的操作，在Helix QAC的文档里，给出来的那种典型的用法，就是用同步的命令，后面带上类型、项目目录，还有那个JSON数据库文件的路径，用这种方式，去把构建的信息，给同步到QAC的项目里面去，等同步完了以后，再去把QAC的项目给打开，检查一下那些源文件、头文件的路径，还有编译的选项，这些是不是都已经被带进来了。
4、去把工具链的配置给确认好
要是项目里用到了ARM、TriCore、PowerPC这一类交叉的编译器，那就得去确认一下，在QAC里面选的那个编译器模型，跟真实的编译命令，是不是能对得上号，编译数据库这个东西，它是能告诉QAC都有哪些参数，但是，这可不等于，所有的编译器自己私有的扩展功能，都能被自动地识别出来。
二、编译数据库导入失败了要怎么修正
当往QAC里导入编译数据库失败了以后，先别急着就去怀疑，是不是QAC的规则配置有什么问题，大多数的导入失败，其实是来自于JSON的格式、路径的写法、编译的命令，还有环境变量，这些东西没有对上号，特别是那种好多人一起搞的项目，或者是靠流水线自动生成的文件，一放到本地的机器上，就更容易出问题了。
1、去检查一下JSON的格式
要先确认好，你拿到的那个文件，它不是一个空的家伙，也不是那种，因为构建失败了，而留下来的半截子内容，可以去找一个能校验JSON格式的工具，去查一查那里面的括号、逗号，还有引号，写得对不对，在Windows的那种路径里面，那些反斜杠，要是没有被好好地转义一下，那也是有可能，会直接导致解析失败的。
2、去检查一下源文件的路径
要是QAC那边一直在提示，说它找不到源文件了，那就要去看一看，那个文件名字段，它写的到底是不是一个绝对路径，又或者，是把目录字段，跟文件名字段，拼到一块儿以后，是不是就真的能找到那个真实的文件了，在代码的目录被改过名字、构建的目录被移动过、或者是分支被切换了以后，那些旧的编译数据库，是会很容易，就指到一些，根本就不存在的路径上去的。
3、去检查一下头文件和宏的定义
要是导入明明是成功了，可是分析却跑失败了，那一个比较常见的原因，就是在编译的命令里面，少了去指定头文件路径的参数、少了去定义宏的参数，又或者是，那个响应的文件，它里面的内容，还没有被展开，这个时候，就可以从那个报了错的源文件开始查起，去把它在编译数据库里的那一条编译命令，给单独地复制出来，然后手动地跑一下看看，是不是所有的头文件，都能被顺顺当当地找到。
4、去检查一下编译器参数的兼容性
有些编译器自己私有的参数、用来链接的参数、还有管告警的参数，这些东西，对QAC的分析来说，是没有什么意义的，有的时候，甚至还会直接导致解析的失败，碰到这种情况，就可以在同步的配置里面，或者在构建导出的那个阶段，去把那些不相干的参数给过滤掉，只把预处理和编译这一步，真正需要的信息，给保留下来。
三、编译数据库导进去以后要怎么复核
当你把编译数据库，成功地导进了QAC以后，这可不代表，这个项目就已经适合拿来分析了，真正要去看的，是那些源文件是不是都齐了、编译的上下文是不是都对头的、还有跑出来的分析结果里面，还有没有大量的，属于解析那一类的错误。
1、去核对一下文件的数量
在同步完了以后，要先去瞅一眼，QAC项目里面的那些源文件的数量，跟实际参与了构建的那些源文件的数量，是不是差不多能对得上，要是发现少了很多，那通常就是，编译数据库里面，只记下来了部分模块的信息，又或者是，那种增量的构建，没有把全量的文件，都给覆盖到。
2、去看一看解析时候报出来的错误
先去跑一次小范围的分析看看，把注意力重点放在，像头文件找不到、类型是未知的、宏没有被定义、关键字它居然不认识，这一类的错误上面，这些错误，它们可不是代码的质量有什么问题，而是编译的那个上下文，还没有被完整地配置好。
3、把那一套生成数据库的流程，给固定下来
等你已经确认了，这套东西是可用的以后，就要去把生成编译数据库的这个步骤，给写到构建的脚本，或者是持续集成的流程里面去，可不要靠着某一个人，从某一台电脑上，靠手工去复制过来，每一次，当分支被切换了、编译的选项发生了变化，或者是工具链升了级以后，都应该去重新生成一次，然后，再把它给同步进来。
4、把失败时候的样本给保留下来
当导入失败了的时候，要记得去把那个JSON的文件、当初同步时候用的命令、报出来的错误日志，还有那个报了错的源文件，都给保存下来，到了后面，再去找供应商要支持，或者是自己内部做复盘的时候，手里有这些材料，是要比光靠嘴去描述，要更容易定位问题的。
总结
在给QAC配置编译数据库的时候，还有当编译数据库导入失败了以后要怎么去修正，这里面比较关键的地方，就是得让QAC，拿到一份真实的、完整的、而且能够被顺利访问到的，编译的上下文，在做配置的时候，要先去生成一份靠得住的编译命令文件，然后再通过同步项目的方式，去把信息给灌进去，接下来，再去核对路径、宏的定义、头文件，还有工具链的参数，当导入失败了以后，也要优先去排查JSON的格式、文件的路径、响应的文件、私有的编译参数，还有环境上的那些差异，只要把这些基础的地方，都给处理干净了，到了后面，再去做MISRA的检查、规则的审计，还有报告的输出，才不会被大量解析层面的错误，给搅得乱七八糟的。
