3. Kconfig 条件与可见性：if语句、visible if条件、prompt与help文本编写规范

在嵌入式 Linux 内核开发中，Kconfig 文件不仅用于定义配置选项，还通过条件与可见性机制控制选项的呈现逻辑。理解 if 语句、visible if 条件以及 prompt 与 help 的编写规范，是构建清晰、可维护的配置体系的核心能力。本章将深入剖析这些机制，并结合嵌入式故障排查场景，帮助您精准控制配置项的依赖与显示。

3.1 if 语句：条件依赖与菜单结构控制

if 语句是 Kconfig 中最基础的条件控制结构，用于根据一个或多个配置符号的值，决定其内部定义的选项是否可见或可配置。它既可以包裹单个选项，也可以包裹整个菜单块。

3.1.1 基本语法与作用域

config FEATURE_A
    bool "Enable Feature A"

if FEATURE_A

config FEATURE_A_SUB_1
    bool "Sub Feature 1"
    help
      This sub feature depends on FEATURE_A.

config FEATURE_A_SUB_2
    bool "Sub Feature 2"

endif # FEATURE_A

在上述示例中，FEATURE_A_SUB_1 和 FEATURE_A_SUB_2 仅在 FEATURE_A 被设置为 y 时才会出现在配置界面中。这种机制有效避免了无关选项的干扰，降低了配置复杂度。

3.1.2 嵌套 if 与复合条件

if 语句支持嵌套，并且条件表达式可以使用 &&（与）、||（或）、!（非）等逻辑运算符。

config ARCH_HAS_MMU
    bool

if ARCH_HAS_MMU

config HIGHMEM
    bool "High Memory Support"

if HIGHMEM && EXPERT

config HIGHMEM_DEBUG
    bool "High Memory Debug"
    depends on DEBUG_KERNEL

endif # HIGHMEM && EXPERT

endif # ARCH_HAS_MMU

这种嵌套结构在嵌入式多平台内核中非常常见，用于隔离不同硬件架构或功能集下的配置项。

3.2 visible if 条件：菜单与注释的可见性控制

visible if 是 Kconfig 中用于控制 menu 和 comment 块整体可见性的关键字。与 if 不同，visible if 不改变内部选项的依赖关系，仅控制菜单或注释块本身是否显示。

3.2.1 语法与典型用法

menu "Advanced Debug Features"
    visible if EXPERT

config DEBUG_IRQ
    bool "IRQ Debugging"
    help
      Enable IRQ debugging hooks.

config DEBUG_SCHED
    bool "Scheduler Debugging"

endmenu

当 EXPERT 未设置时，整个“Advanced Debug Features”菜单在配置界面中完全隐藏，但其内部的 DEBUG_IRQ 和 DEBUG_SCHED 选项仍然可以通过其他方式（如直接设置 .config 文件）进行配置。这种机制常用于隐藏面向专家的高级选项，同时保持配置文件的向后兼容性。

3.2.2 visible if 与 if 的对比

3.3 prompt 文本编写规范

prompt 是配置选项在用户界面中显示的文本。一个清晰、一致的 prompt 能显著提升配置效率，减少误配置。

3.3.1 基本规则

• 简洁明了： 使用动词或名词短语开头，如“Enable ...”、“Support for ...”、“Driver for ...”。
• 避免缩写： 除非是行业通用缩写（如 DMA、MMU、USB），否则应使用全称。
• 长度控制： 建议不超过 60 个字符，确保在 menuconfig 界面中完整显示。
• 层级一致： 同一菜单下的 prompt 风格应保持一致。

3.3.2 常见模式与反模式

3.4 help 文本编写规范

help 文本是配置选项的详细说明，对于嵌入式故障排查至关重要。一个优秀的 help 文本应包含：选项功能、依赖关系、典型值、性能影响以及调试建议。

3.4.1 标准结构

config DMA_ENGINE
    bool "DMA Engine support"
    help
      Select this option if you want to enable the DMA Engine subsystem.
      DMA Engine provides a unified API for DMA controllers.

      If unsure, say N. Most embedded systems require DMA for
      high-throughput peripherals (e.g., audio, camera, storage).

      For debugging, enable DMA_ENGINE_DEBUG to trace descriptor
      allocation and transfer completion.

3.4.2 嵌入式场景的 help 编写要点

• 明确依赖： 说明该选项依赖哪些其他配置，以及不满足依赖时的后果。
• 提供默认建议： 对于常见嵌入式平台，给出“推荐开启”或“推荐关闭”的建议。
• 调试指引： 如果该选项有对应的调试开关或日志级别，应在 help 中注明。
• 性能与资源： 说明开启该选项对内存、CPU 或启动时间的影响。

3.5 综合示例：一个完整的 Kconfig 片段

以下示例综合了 if、visible if、prompt 和 help 的规范用法，模拟一个嵌入式音频子系统的配置。

menu "Audio Subsystem"
    visible if EXPERT || SND_SOC

config SND_SOC
    tristate "ALSA for SoC audio"
    select SND_PCM
    help
      Say Y or M to enable ALSA SoC (System on Chip) audio support.
      This is required for most embedded audio codecs.

      If unsure, say Y for desktop-like systems, N for minimal
      headless systems.

if SND_SOC

config SND_SOC_DEBUG
    bool "SoC Audio Debug"
    depends on DEBUG_KERNEL
    help
      Enable verbose debug output for SoC audio operations.
      Requires DEBUG_KERNEL. Logs are available via dmesg
      with dynamic debug control.

      WARNING: This may generate a large amount of log data
      and impact audio latency.

config SND_SOC_MY_CODEC
    tristate "Support for MyCustom Audio Codec"
    depends on I2C
    select REGMAP_I2C
    help
      Driver for the MyCustom AC108 audio codec.
      This codec is used on the MyBoard-v2 platform.

      Features:
        - 24-bit stereo ADC/DAC
        - Sample rate: 8kHz - 96kHz
        - I2C control interface

      To debug codec register access, enable
      SND_SOC_DEBUG and check /sys/kernel/debug/regmap/*.

endif # SND_SOC

endmenu

3.6 故障排查视角：条件与可见性常见问题