最近在用Source Insight（以下简称SI）阅读代码的过程中，发现Linux内核的条件编译太多了，很影响阅读效率。探索了一下SI的界面，发现在“Project->Project Settings...->Conditional Parsing->Conditions...”是有条件解析的配置的，且支持以特定的xml格式导入预编译宏。于是写了一个转换脚本，把Linux内核的.config配置文件转换成SI的.conditions.xml配置文件。导入之后就可以让SI不解析实际上没有被编译进去的内核代码，而且会以特定的格式显示无用代码，减少了阅读代码时的干扰。最终效果，如下图：

按下面的指南操作，你就可以达到一样的效果。

1、转换脚本“lkc2sicx.py”所做的工作

用“make menuconfig”修改内核配置后会生成.config文件。该配置文件中典型的配置项有如下几种：

# CONFIG_LOCALVERSION_AUTO is not set    ① 未配置的配置项
CONFIG_PROC_KCORE=y    ② 选中的配置项
CONFIG_NF_NAT_IPV4=m    ③ 选中并要求编译成模块的配置项
CONFIG_DEFAULT_TCP_CONG="cubic"    ④ 字符串配置项
CONFIG_SPLIT_PTLOCK_CPUS=4    ⑤ 数字配置项

再来看看SI的配置文件格式。在SI的“Conditional Parsing”界面，添加了如下的3个配置：

“Export...”这个配置，产生的xml配置文件格式如下：

<?xml version="1.0" encoding="utf-8"?>
<SourceInsightParseConditions
    AppVer="4.00.0084"
    AppVerMinReader="4.00.0019"
    >
    <ParseConditions>
        <Defines>
            <define id="a" value="1" />
            <define id="b" value="0" />
            <define id="c" value="" />
        </Defines>
    </ParseConditions>
</SourceInsightParseConditions>

xml格式较为简单。只要进行如下转换即可，

# CONFIG_LOCALVERSION_AUTO is not set    =>    <define id="CONFIG_LOCALVERSION_AUTO" value="" />
CONFIG_PROC_KCORE=y    =>    <define id="CONFIG_PROC_KCORE" value="1" />
CONFIG_NF_NAT_IPV4=m    =>    <define id="CONFIG_NF_NAT_IPV4" value="1" />
CONFIG_DEFAULT_TCP_CONG="cubic"    =>    <define id="CONFIG_DEFAULT_TCP_CONG" value="cubic" />
CONFIG_SPLIT_PTLOCK_CPUS=4    =>    <define id="CONFIG_SPLIT_PTLOCK_CPUS" value="4" />

.config中未配置的项也要生成是因为，SI默认是忽略条件编译的宏的。如果不显示说明未定义这个宏，SI在解析代码的时候就会忽略条件编译指令，直接解析到宏内部的代码^[1]。

2、下载并使用转换脚本

下载 >> lkc2sic_v1.0.zip
下载之后解压，在命令行运行lkc2sicx.py脚本转换配置。用法示例：

$ ./lkc2sicx.py -s kernel.example.config -d example

当前目录下就会生成“example.conditions.xml”的SI条件解析配置文件，在SI中导入该文件，重建项目即可。

3、修改非激活代码显示样式
在SI中未解析的代码被称为未激活代码(Inavtive code)，默认格式是灰色的，没有删除线。为了更加醒目，可以修改一下未激活代码的格式。“Options->Style Properties...->Style Name->Inactive Code”，将字体配置的“Strike-Thru”设置为“ON”即可。如下图：

参考
[1] Source Insight 4.0 用户手册，Source Dynamic.Inc

修订记录
2017-11-01 PM：从网易博客迁移到简书；
2017-10-27 PM：完成初稿；

版权声明：自由转载-非商用-非衍生-保持署名（创意共享3.0许可证）