4. Kconfig语法详解：config条目、menu与menuconfig、choice与endchoice、dependencies与select、source与rsource

好，咱们今天来啃一块硬骨头——Kconfig语法。说实话，我刚接触NuttX那会儿，看到Kconfig文件里一堆关键字，头都大了。但后来发现，这东西说白了就是一套配置菜单的描述语言。你掌握了它，就能随心所欲地裁剪你的系统。

我个人习惯把Kconfig语法分成五个核心部分来理解。咱们一个一个过。

4.1 config条目：最基础的配置项

config 是Kconfig里最基本的单元。它定义了一个可配置的选项，通常对应一个宏定义。

config EXAMPLE_FEATURE
    bool "Enable Example Feature"
    default n
    help
        This is an example feature for demonstration.

这里的关键点：

  • 类型：bool 表示开关量，还有 int、hex、string 等类型
  • 提示字符串："Enable Example Feature" 就是菜单里显示的文字
  • 默认值：default n 表示默认关闭
  • 帮助信息：help 后面跟的是说明文字
小技巧：我建议每个config条目都写上help信息。哪怕就一句话。你想想看，三个月后你自己回来看代码，没有help信息，你都得猜这个选项是干嘛的。

4.2 menu与menuconfig：组织你的配置菜单

当配置项多了，就需要用菜单来组织。menu 和 menuconfig 就是干这个的。

menu：纯菜单容器

menu "Networking Support"
    config NET_TCP
        bool "TCP Protocol"
        default y

    config NET_UDP
        bool "UDP Protocol"
        default y
endmenu

这段代码会在配置界面里生成一个叫"Networking Support"的菜单，里面包含TCP和UDP两个选项。

menuconfig：带开关的菜单

menuconfig USB_DEVICE
    bool "USB Device Support"
    default n

if USB_DEVICE
    config USB_DEVICE_CDCACM
        bool "CDC ACM Serial"
        default n

    config USB_DEVICE_MSC
        bool "Mass Storage Class"
        default n
endif

menuconfig 和 menu 的区别在于：menuconfig 本身就是一个配置选项，只有它被选中了，里面的子选项才会出现。

避坑指南：我曾经在一个项目里，把menuconfig和menu混用，结果子菜单死活不显示。后来才发现，menuconfig必须配合if...endif或者depends on来使用，否则子选项不会受它控制。

4.3 choice与endchoice：单选逻辑

有时候你需要让用户从几个选项中选一个。比如选择调度算法、选择内存分配策略等。这时候就用 choice 和 endchoice。

choice
    prompt "Scheduling Algorithm"
    default SCHED_RR

config SCHED_FIFO
    bool "FIFO Scheduling"
    help
        First In, First Out scheduling.

config SCHED_RR
    bool "Round Robin Scheduling"
    help
        Round Robin scheduling with time slices.

config SCHED_SPORADIC
    bool "Sporadic Scheduling"
    help
        Sporadic server scheduling for real-time tasks.

endchoice

这里要注意几点：

  • prompt 是给用户看的提示文字
  • default 指定默认选中的选项
  • 同一时刻只能选中一个选项
注意：choice里面的选项类型必须是bool。而且，如果你没有指定default，Kconfig会默认选中第一个选项。这有时候会坑到你——我就在一个项目里因为没写default，结果编译出来的系统用了错误的调度算法，排查了半天。

4.4 dependencies与select：依赖与反向选择

这是Kconfig里最强大的机制之一。它控制着配置项之间的依赖关系。

depends on：正向依赖

config USB_DEVICE
    bool "USB Device Support"
    depends on USB

config USB_DEVICE_CDCACM
    bool "CDC ACM Serial"
    depends on USB_DEVICE

这里的意思是：只有 USB 被选中了，USB_DEVICE 才会出现；只有 USB_DEVICE 被选中了，USB_DEVICE_CDCACM 才会出现。

select：反向依赖

config USB_DEVICE_CDCACM
    bool "CDC ACM Serial"
    select USB_DEVICE
    select SERIAL

select 的意思是：当我选中 USB_DEVICE_CDCACM 时，自动帮我选中 USB_DEVICE 和 SERIAL。这就像是在说：「我要用这个功能，它依赖的那些东西你也得给我打开。」

经验之谈：我建议尽量用depends on，少用select。为什么？因为select是强制性的，它不管被选中的选项有没有自己的依赖条件。我曾经用select把一个选项打开，结果它依赖的另一个选项没满足条件，编译直接报错。depends on就温和多了，它会自动帮你处理依赖链。

4.5 source与rsource：文件包含

当你的项目越来越大，把所有配置写在一个Kconfig文件里显然不现实。source 和 rsource 就是用来拆分文件的。

source "drivers/Kconfig"
source "net/Kconfig"
source "fs/Kconfig"

source 会把指定文件的内容包含进来，就像C语言的 #include 一样。

rsource 是相对路径版本的source。它相对于当前文件所在目录来解析路径。

# 在 arch/arm/Kconfig 中
rsource "common/Kconfig"    # 实际路径是 arch/arm/common/Kconfig
小建议：我习惯用rsource而不是source。因为source是基于源码根目录的，一旦你移动了Kconfig文件的位置，source路径就得改。rsource是相对路径，移动文件时只需要改当前文件里的路径就行，维护起来方便很多。

知识体系总览

说了这么多，咱们用一张图来总结一下Kconfig语法的核心结构：

Kconfig语法核心结构 Kconfig 配置系统 config 条目 bool / int / hex / string default / help / prompt menu / menuconfig menu ... endmenu menuconfig + if ... endif choice / endchoice prompt / default 单选逻辑（互斥选项） dependencies / select depends on（正向依赖） select（反向选择） source / rsource source（绝对路径） rsource（相对路径） 核心要点 • config：定义单个配置项 • menu/menuconfig：组织菜单结构 • choice：实现单选逻辑 • depends on/select：控制依赖关系 • source/rsource：拆分配置文件

这张图把Kconfig的五个核心语法要素都串起来了。你写Kconfig文件的时候，脑子里要有这个结构图——先想清楚你要定义什么类型的配置项，然后决定怎么组织它们，最后处理好依赖关系。

嗯，Kconfig语法这块儿就讲这么多。说实话，这些语法规则看着多，但用熟了之后，你会发现它们其实就那么几个套路。关键是动手去写，去改，去调试。我在NuttX里改过上百个Kconfig文件，踩过的坑比你们吃过的盐还多（开个玩笑）。但正是这些坑，让我真正理解了Kconfig的设计哲学——用最简洁的语法，表达最复杂的配置逻辑。

最后提醒一句：写Kconfig的时候，一定要保持一致性。命名风格、缩进方式、注释格式，这些细节决定了你的配置系统好不好维护。我见过一个项目，Kconfig文件里有的用tab缩进，有的用空格，有的混用，结果配置工具解析的时候直接报错。这种低级错误，咱们就别犯了。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →