用途
该页面属于 Kotlin/Compose 常见陷阱（footgun）系列，专门解释并给出修复方案：两个能感知窗口 Insets 的栏（如 TopAppBar、SearchBar、BottomAppBar）在同一个 Column 中作为兄弟节点堆叠时，会各自预留一次系统栏空间，从而在两者之间产生一条与状态栏等高的空白带。页面面向 Compose 开发者，帮助其在代码审查和调试中识别并避免“双重消费 Insets”问题。
核心规则
Modifier.windowInsetsPadding(insets) 会按 Insets 添加内边距，并把该 Insets 标记为已消费，但消费只沿父子链向下传递，不会横向传给兄弟节点。因此，Column 中两个兄弟栏都读到完整且未消费的 Insets，各自内边距一次，结果第二条栏在已处于状态栏下方的基础上又预留一次状态栏高度，两者之间出现一条与状态栏等高的空白带。
同一元素上的修饰符链（如 Modifier.navigationBarsPadding().imePadding()）是父子关系，后面的节点会看到前面已消费的值，因此不会叠加；两个兄弟节点上的同类修饰符则会各自完整生效。
主要能力与建议
- 两种正确写法：要么由容器统一消费一次（在 Column 上使用
Modifier.windowInsetsPadding(...)，所有堆叠子项传入WindowInsets(0)）；要么由第一个子项拥有消费（顶栏保留默认值，其下所有堆叠子项传零）。混用两种写法或漏掉某个子项会重新引入空白带。 - 参数默认值应取框架值：给可堆叠组件新增
windowInsets: WindowInsets = TopAppBarDefaults.windowInsets参数对现有调用方是无操作，安全；若默认设为WindowInsets(0)，会静默移除所有覆盖式调用点的 Insets，导致原本正确的栏落到状态栏下方。 - 置零会丢失的不只是顶部：顶栏的框架默认值还覆盖横向系统栏两侧。替换为
WindowInsets(0)会连带丢失横屏侧边 Insets，在带挖孔的设备上首个图标可能滑入挖孔区域。统一消费 Insets 的容器需要同时承载这些侧边 Insets，或者让堆叠子项使用仅横向的 Insets，而不是扁平零值。 - 条件模式下才可见：若选择栏包裹在
AnimatedVisibility(selectionActive)中，只在选择模式下堆叠，则空白带只在该模式出现；同一组件在覆盖式替换场景下代码相同却没问题。只有“第二条栏可见”且“确实堆叠而非覆盖”同时成立时才会暴露。 - 先测量再命名：两栏之间的死区可能有多种来源（spacedBy、padding 常量、多余 Spacer）。本问题的空白高度恰好等于状态栏，随设备变化，在无系统栏的桌面窗口上消失。若在无系统栏窗口中仍存在间隙，则不是本问题。
- 不要反向减回去：用负 offset 或硬编码
-24.dp抵消双重 Insets 只在那台测量设备上正确，在其他设备、横屏、分屏下都会出错。Insets 是运行时值，正确做法是停止重复预留。 - Scaffold 的 PaddingValues 只预留不消费：
Modifier.padding(innerPadding)是普通内边距，不向下传递消费信息，其内部栏若保留默认 Insets 会再预留一次。应搭配Modifier.consumeWindowInsets(innerPadding)，或显式给子项传零。 - 显式零值可能冗余但仍值得写：在已消费的容器下，子项通过
windowInsetsPadding解析 Insets 本就会得到零，传零不改变行为；但它能经受消费位置重构，并且对直接读取WindowInsets.statusBars原始值的子项是唯一有效的手段（原始读取完全忽略消费状态）。
使用方式：验证
页面给出四条 grep 命令用于排查：
- 查找所有
windowInsets参数声明与实参（windowInsets *[:=]），注意正则闭合在=会匹配实参而非可堆叠组件声明。 - 查找所有零值（
windowInsets = WindowInsets\(0），注意开括号，因为WindowInsets(0)与WindowInsets(0, 0, 0, 0)是同一实参；命中项不全是堆叠栏，sheet 或 dialog 置零是因为它们自行处理 Insets。 - 查找所有消费点（
windowInsetsPadding\(|consumeWindowInsets\(），与第 1 步对照：消费是零值正确的前提，若某屏幕传零但其上方没有消费点，则堆叠有误。 - 找出持有多个栏的屏幕候选（匹配
TopAppBar|SearchBar|BottomAppBar并统计文件内出现次数大于 1），逐一判断栏是 Column 中的兄弟（堆叠：除一个外都传零）还是 Box 中的覆盖（全部保留默认）。
随后在带可见状态栏的设备上进入堆叠模式，对比两栏间隙与状态栏高度；切到横屏检查横向侧边 Insets；最后在 Insets 为零的环境（桌面窗口或全屏隐藏系统栏）运行同一屏幕，确认两种构建布局一致，以证明空白带来自 Insets 而非 padding 常量。
适用场景与限制
适用于使用 Jetpack Compose 构建 Android 界面、存在多个栏堆叠或依赖 WindowInsets 的开发者。页面内容为具体技术规则与排查方法，不涉及价格、平台限制或其他收费信息；未提及的内容暂未提供。
相关条目
页面末尾提及相关条目：selection-mode-state-holder（选择模式状态持有者）与 responsive-gate-size-not-platform（响应式断点判断的另一个原因）。