SwiftUI ScrollView scrollTargetLayout不生效：点击多次按钮才触发滚动

嘿，我来帮你搞定这个头疼的问题！你遇到的这个点击好几次+按钮才触发ScrollView滚动的情况，基本不是iOS的bug，咱们从代码设置里找找原因就行～

先把你没写完的代码补全（应该是这个样子吧？）：

struct BrokenVerticalScrubberDemo: View {
    @State private var scrollPosition: Int? = 0
    @State private var count: Int = 20

    var body: some View {
        VStack {
            Button("+") {
                scrollPosition = (scrollPosition ?? 0) + 1
            }
            
            ScrollView(.vertical) {
                LazyVStack(spacing: 0) {
                    ForEach(0..<count, id: \.self) { index in
                        Text("Item \(index)")
                            .frame(height: 50)
                            .frame(maxWidth: .infinity)
                            .background(index % 2 == 0 ? .blue : .green)
                    }
                }
                .scrollTargetLayout()
            }
            .scrollPosition(id: $scrollPosition)
            .scrollTargetBehavior(.viewAligned)
        }
    }
}

问题根源分析 #

你遇到的多次点击才滚动的情况，核心原因是ScrollView没有及时响应scrollPosition的状态更新，常见的诱因有这几个：

1. 状态更新和ScrollView的滚动逻辑没有同步，SwiftUI可能把多次scrollPosition的更新合并成了一次处理
2. ScrollView的布局（比如没有明确高度）导致滚动目标的位置计算出现偏差
3. scrollTargetBehavior的设置和布局的对齐逻辑没有完全匹配

具体解决办法 #

我给你几个亲测有效的调整方案，你可以挨个试试：

• 用withAnimation包裹状态更新
  直接修改按钮的点击事件，把scrollPosition的更新放在withAnimation里，这样能让状态变化和滚动动画同步，强迫ScrollView立刻响应滚动指令：

  Button("+") {
      withAnimation {
          scrollPosition = (scrollPosition ?? 0) + 1
      }
  }
  

  这个方法大概率能直接解决你的问题，因为很多时候就是状态更新的时机没跟上，动画包裹后SwiftUI会优先处理滚动动作。

• 给ScrollView设置明确的frame
  如果你的ScrollView没有固定高度，父布局的变化可能会干扰滚动目标的计算。给ScrollView加个明确的高度：

  ScrollView(.vertical) {
      // 内部的LazyVStack和scrollTargetLayout保持不变
  }
  .frame(height: 400) // 这里可以根据你的布局调整高度
  .scrollPosition(id: $scrollPosition)
  .scrollTargetBehavior(.viewAligned)
  

• 检查滚动目标的id唯一性
  你用ForEach(0..<count, id: \.self)是没问题的，但如果后续修改了count或者item的顺序，要确保每个item的id是稳定唯一的，避免ScrollView找不到目标。

验证效果 #

调整完之后，你再点击+按钮试试，应该每次点击都会立刻滚动到下一个item，不会再出现要按好几次的情况啦。

备注：内容来源于stack exchange，提问作者Deepak Sharma