用 SwiftUI 构建数据驱动布局、列表、表单…

在 SwiftUI（iOS 17+，面向 iOS 26）中搭建堆栈/网格/列表/滚动视图/表单/搜索/浮层界面时，如何选择容器并正确实现。

适用场景

解决思路

1. 小规模固定内容用 VStack、HStack、ZStack，它们会立即渲染所有子视图。
2. 大规模或动态集合在 ScrollView 内用 LazyVStack、LazyHStack，按需创建子视图。
3. 图标选择器、媒体画廊、密集视觉选择用 LazyVGrid；跨设备尺寸用 .adaptive 列，固定列数用 .flexible 列。
4. 用 .aspectRatio 控制单元格尺寸；不要在懒加载容器内放 GeometryReader，需要读取尺寸时用 .onGeometryChange（iOS 16+）。
5. 信息流和设置行用 List：信息流用 .listStyle(.plain)，设置用 .insetGrouped。
6. 主题化表面用 .scrollContentBackground(.hidden) 加自定义背景；用 .listRowInsets(...) 和 .listRowSeparator(.hidden) 控制间距与分隔线。
7. 边缘滚动用 List + ScrollPosition 配合 .scrollPosition($scrollPosition) 实现顶部/底部滚动。
8. 跳转到某项或某分区用 ScrollView + 懒加载堆栈，配合 .scrollTargetLayout() 和稳定 target 实现可靠的 scroll-to-id。
9. 下拉刷新用 .refreshable { }；整行可点击的行加 .contentShape(Rectangle())。
10. iOS 26 用 .scrollEdgeEffectStyle(.soft, for: .top) 实现现代滚动边缘效果。
11. 需要自定义布局、混合内容或横向滚动时用 ScrollView 配合懒加载堆栈。
12. 用 ScrollPosition 做声明式双向滚动位置跟踪与程序化滚动，配合 .scrollTargetLayout() 和 .scrollPosition($scrollPosition)。
13. 用 safeAreaInset(edge:) 把输入栏、工具栏固定在键盘上方且不影响滚动布局。
14. iOS 26 可用 .scrollEdgeEffectStyle(.soft, for: .top) 做渐隐边缘、.backgroundExtensionEffect() 做安全区边缘镜像/模糊（每屏最多一处）、.safeAreaBar(edge:) 挂载与滚动效果集成的栏视图。
15. 结构化设置与输入界面用 Form，把相关控件分组到 Section 中，配合 .formStyle(.grouped) 和 .scrollContentBackground(.hidden)。
16. 输入密集的表单用 @FocusState 管理键盘焦点；仅在独立呈现或 sheet 中时才包 NavigationStack。
17. 控件选型：Toggle 用于布尔偏好；Picker 用于离散选择（2-4 项用 .segmented）；Slider 用于带可见数值标签的数值范围；DatePicker 用于日期/时间；TextField 配合 .keyboardType、.textInputAutocapitalization。
18. 控件直接绑定 @State、@Binding 或 @AppStorage；相关控件分组到 Form 的 Section；用 .disabled(...) 反映锁定或继承的设置；Toggle 内用 Label 组合图标与文字。
19. 用 .searchable 添加原生搜索 UI，用 .searchScopes 支持多模式，用 .task(id:) 做防抖异步结果。
20. 搜索为空时显示占位内容；对输入做防抖避免过度请求；搜索状态保持在视图本地；不要对空字符串执行搜索。
21. 瞬时 UI（toast、banner）用 .overlay(alignment:) 且不影响布局，配合 transition 和短暂自动消失计时器。
22. 浮层对齐到明确边缘（.top 或 .bottom）；不要堆叠多个浮层，用队列或替换当前 toast；除非明确需要，避免浮层阻塞所有交互。
23. 模态路由、sheet detent 和全屏呈现策略交给 swiftui-navigation 技能处理。
24. 避免常见错误：懒加载容器内不放 GeometryReader；ForEach 用稳定 Identifiable ID 而非数组下标；避免同轴嵌套滚动视图；重型或可展开的 List 行改用 ScrollView + LazyVStack；大选项集用菜单或内联 picker 样式而非 .segmented；除非有明确间距需求，省略 stack/grid 的 spacing: 以使用平台自适应默认值；滚动揭示由一个归一化进度值驱动，而非并行布尔或重复拖拽手势；每帧滚动几何保持在局部，避免改变用于计算进度的几何。
25. 按检查清单核对：大/动态集合用 LazyVStack/LazyHStack；ForEach 项有稳定 Identifiable ID；懒加载容器内无 GeometryReader；List 样式匹配场景；结构化输入用 Form；.searchable 用 .task(id:) 防抖；数据源支持时加 .refreshable；浮层有 transition 和自动消失计时器；可点击行加 .contentShape(Rectangle())；表单用 @FocusState 管理焦点；除非需要特定值否则省略 spacing:；滚动揭示用单一归一化进度值且几何更新限制在窄子树；冲突的缩放/裁剪交互禁用滚动，离散可见性效果不驱动连续动画。

适用边界 · 注意事项

• 需要模态路由、sheet detent 或全屏呈现策略时，应使用 swiftui-navigation 技能而非本技能。
• 需要弹簧动画、过渡与时序选择时，应交给 swiftui-animation 技能。
• 需要架构与状态管理方案时，应参考 swiftui-patterns 技能。