1. Kconfig 基础：语法概述与核心关键字

Kconfig 是 Linux 内核配置系统的描述语言，用于定义内核功能模块的开关、依赖与互斥关系。所有 Kconfig 文件遵循统一的语法结构，由 menu、config、choice 等关键字组织成树形配置菜单。理解 Kconfig 语法是进行嵌入式内核裁剪与故障排查的第一步。

1.1 Kconfig 语法概述

Kconfig 文件采用基于关键字的声明式语法，每条配置项以 config 开头，后跟配置宏名称（如 CONFIG_USB）。语法规则如下：

• 缩进敏感：子项（如 depends on、select）使用 Tab 或空格缩进，推荐统一使用 Tab。
• 类型声明：每个 config 必须指定类型：bool（二值）、tristate（三态：y/n/m）、int、hex、string。
• 提示信息：类型后紧跟 prompt 字符串，显示在菜单中。
• 默认值：使用 default y 或 default n 指定默认状态。
• 注释：以 # 开头，仅用于说明，不参与解析。

1.2 核心关键字：menu / config / choice / endmenu / endchoice

Kconfig 使用五个核心关键字构建配置菜单的层次结构：

以下是一个完整的 Kconfig 片段，展示菜单嵌套与配置项定义：

menu "USB Support"

config USB_SUPPORT
    bool "USB support"
    default y
    help
      Say Y here if your system has a USB host controller.

config USB_OHCI_HCD
    tristate "OHCI HCD support"
    depends on USB_SUPPORT
    help
      Support for USB OHCI controllers.

choice
    prompt "USB Speed"
    depends on USB_SUPPORT

config USB_SPEED_LOW
    bool "Low Speed (1.5 Mbps)"

config USB_SPEED_FULL
    bool "Full Speed (12 Mbps)"

config USB_SPEED_HIGH
    bool "High Speed (480 Mbps)"

endchoice

endmenu

1.3 依赖关系：depends on 与 select

Kconfig 通过 depends on 和 select 管理配置项之间的依赖与反向选择关系，这是嵌入式故障排查中常见的配置冲突根源。

depends on：正向依赖

表示当前配置项只有在依赖项被启用时才能可见或可选中。如果依赖项为 n，则当前项自动隐藏或强制为 n。

config I2C
    tristate "I2C support"

config SENSOR_TMP102
    tristate "TMP102 temperature sensor"
    depends on I2C
    help
      This driver supports the TMP102 sensor over I2C.

上例中，SENSOR_TMP102 只有在 I2C 被选中（y 或 m）时才会出现在菜单中。

select：反向依赖（强制选中）

表示当当前配置项被选中时，自动强制选中 select 指定的其他配置项。常用于驱动需要底层硬件支持时。

config DRM_PANEL_SIMPLE
    tristate "Simple panel driver"
    select BACKLIGHT_CLASS_DEVICE
    select REGULATOR
    help
      Driver for simple display panels.

上例中，选中 DRM_PANEL_SIMPLE 会自动启用 BACKLIGHT_CLASS_DEVICE 和 REGULATOR，无需用户手动配置。

1.4 Kconfig 依赖关系结构图

下图展示了一个典型的 Kconfig 依赖关系拓扑，包含菜单分组、配置项、正向依赖和反向选择：

1.5 常见配置冲突与排查清单

在嵌入式内核裁剪中，Kconfig 依赖关系错误是导致编译失败或功能缺失的常见原因。以下清单总结了典型问题：