本文强调 约束（Constraints） 如何在父子间传递、以及「为什么 Row 不够用才写 Layout」。

配套示例

CustomLayoutLabScreen.kt 中 HorizontalTapeLayout：横向依次 measure → 累加宽度 → placeRelative。

---

1. 两阶段心智

1. Measure：父把 Constraints 传给子，子返回自己在该约束下的尺寸；普通 Layout 中，同一个 Measurable 在一次 measure pass 里不要重复 measure。
2. Place：父拿到 Placeable 后，在自身坐标系里摆放子项 z-order 即调用顺序。

Layout(content) { measurables, constraints -> … } lambda 必须返回 layout(width, height) { … }；空子项早退也要 return@Layout layout(0, 0) {}。

---

2. 约束里的「无界方向」陷阱

在滚动容器里，滚动方向上的约束可能是无界的：垂直滚动 常见 maxHeight = Constraints.Infinity，横向滚动 常见 maxWidth = Constraints.Infinity。自定义 Layout 要明确自己支持哪种无界方向，否则容易出现测量失败或尺寸不符合预期。

技巧：像本示例一样 constraints.copy(minWidth = 0, minHeight = 0) 再给子 measure，只是在 放松最小约束，避免子项被父级最小尺寸强制撑开；它不会消除 maxWidth / maxHeight 的无界问题。真正生产里要按设计定义 固定尺寸、裁切、滚动、换行或 weight 语义。

本示例的 HorizontalTapeLayout 会把最终 width 限制在父约束内；如果子项总宽度超过父宽，后续子项仍会按原宽度继续 placeRelative，超出部分可能不可见。这是教学 demo 可接受的简化，生产组件应明确「裁切 / 横向滚动 / 自动换行」策略。

---

3. 何时别写 Layout

需求	更优先
等分、权重	Row + Modifier.weight
链式约束	ConstraintLayout（Compose 版）
重叠对齐	Box + align
复杂可复用测量	自定义 Layout 或 SubcomposeLayout（更强大也更难）

SubcomposeLayout：需要先量内容再决定子项数量/尺寸（如 Flow）时用；性能与调试成本更高，评审门槛应更高。

---

4. 避坑清单

• 在 measure 里读 State 副作用：会触发 额外订阅，测量阶段逻辑要 纯。
• 忘记 coerceIn：sumOf(width) 超出父 maxWidth 时直接 layout(sum, …) 可能违反父约束；但只 coerceIn 不等于完成布局策略，还要决定超出内容如何处理。
• Intrinsic 测量：width(IntrinsicSize.Min) 等会触发 额外测量路径，列表里滥用会卡。

---

5. 自检清单

1. 自定义 Layout 的 measure lambda 里是否避免读写会触发订阅的 State？
2. 子项宽度之和超过父 maxWidth 时，是否做了 coerceIn 并明确裁切、换行或滚动策略，而不是直接 layout(超宽, …)？
3. 在滚动方向无界时，是否区分 竖向滚动的无界高度 与 横向滚动的无界宽度，并按布局语义处理 Infinity？
4. 需求是否真到了非 Layout 不可？是否已排除 Row+weight、Box、ConstraintLayout？

参考答案（复习用）

1. 应避免。measure 阶段保持纯函数；需要随状态变的尺寸，在组合外层读 state，把 算好的 constraints 或 flag 传入 Layout，而不是在 measurables 循环里 state.value 副作用订阅。
2. 必须处理。否则违反父约束或裁切异常；要么限制每子最大宽、要么 sum.coerceAtMost(constraints.maxWidth) 后明确截断/裁切，或改用可滚动容器、换行布局。
3. 必须区分方向。constraints.copy(minWidth = 0, minHeight = 0) 只是放松最小约束；遇到 maxWidth / maxHeight = Constraints.Infinity 时，应按组件语义限制尺寸、滚动或换行。
4. 优先用现成布局。仅当 Flow、胶带横向排列、特殊重叠测量等 Row/Column 表达不了 时再写 Layout；SubcomposeLayout 更晚引入，需额外评审。

---

源码仓库：ComposeDemo（分支 main）

相关推荐

《重组与参数稳定性：跳过规则、derivedStateOf 与调试》

《测试分层：JVM 单测、ViewModel 测试与 Compose UI Test》

《Material3 组件选择、状态管理与避坑指南》