SwiftUI ScrollView滚动方向检测优化：防抖/锁定方案求助

问题核心 #

在UIKit导航栈中嵌入SwiftUI ScrollView时，通过PreferenceKey监听滚动偏移量判断方向，快速滚动时表现正常，但慢速拖动时微小的偏移波动会导致方向频繁切换，触发导航栏/TabBar的重复动画，最终引发界面卡顿。以下是针对iOS 16+的几种优化方案及代码实现。

优化方案与实现 #

1. 方向锁定+防抖组合策略

结合方向锁定（避免微小反向偏移触发状态切换）和防抖延迟（过滤短时间内的波动信号），确保只有稳定的滚动方向才会触发界面状态变化。

import SwiftUI
import Combine

struct ContentView: View {
    // 增大最小切换阈值，过滤微小偏移
    private let minimumDirectionChangeOffset = 20.0
    // 防抖延迟，过滤短时间内的波动
    private let debounceDelay: TimeInterval = 0.15
    
    @State private var lastOffset: CGFloat = 0
    @State private var isNavigationBarHidden = false
    // 方向锁：锁定当前滚动方向，直到反向偏移超过阈值才解锁
    @State private var directionLock: ScrollDirection? = nil
    private var cancellable: AnyCancellable?
    
    enum ScrollDirection {
        case up, down
    }
    
    var body: some View {
        ScrollView {
            LazyVStack(spacing: 20) {
                ForEach(0..<50) { index in
                    Text("Item \(index)")
                        .frame(maxWidth: .infinity, minHeight: 100)
                        .background(Color.gray.opacity(0.2))
                }
            }
            .background(
                GeometryReader { proxy in
                    Color.clear
                        .preference(key: ScrollOffsetKey.self, value: proxy.frame(in: .named("scrollView")).minY)
                }
            )
        }
        .coordinateSpace(name: "scrollView")
        .onPreferenceChange(ScrollOffsetKey.self) { offset in
            handleScrollOffsetChange(offset: offset)
        }
        .navigationBarTitleDisplayMode(.inline)
        .navigationBarHidden(isNavigationBarHidden)
        // 同步控制TabBar显隐
        .onChange(of: isNavigationBarHidden) { hidden in
            guard let tabBarController = UIApplication.shared.connectedScenes
                .compactMap({ $0 as? UIWindowScene })
                .first?.windows
                .first?.rootViewController as? UITabBarController else { return }
            
            UIView.animate(withDuration: 0.3) {
                tabBarController.tabBar.isHidden = hidden
            }
        }
    }
    
    private func handleScrollOffsetChange(offset: CGFloat) {
        let offsetDiff = offset - lastOffset
        
        // 过滤1pt以内的微小偏移，避免噪声触发
        guard abs(offsetDiff) >= 1 else { return }
        
        let currentDirection: ScrollDirection = offsetDiff > 0 ? .down : .up
        
        if let lockedDirection = directionLock {
            // 已有锁定方向，仅当反向偏移超过阈值时才切换
            if lockedDirection != currentDirection && abs(offsetDiff) >= minimumDirectionChangeOffset {
                directionLock = currentDirection
                triggerStateUpdate(direction: currentDirection)
            }
        } else {
            // 无锁定状态，偏移超过阈值触发切换
            if abs(offsetDiff) >= minimumDirectionChangeOffset {
                directionLock = currentDirection
                triggerStateUpdate(direction: currentDirection)
            }
        }
        
        lastOffset = offset
    }
    
    private func triggerStateUpdate(direction: ScrollDirection) {
        // 防抖：取消之前的延迟任务，重新计时
        cancellable?.cancel()
        cancellable = Just(direction)
            .delay(for: .seconds(debounceDelay), scheduler: DispatchQueue.main)
            .sink { [weak self] direction in
                guard let self = self else { return }
                withAnimation(.easeInOut(duration: 0.3)) {
                    self.isNavigationBarHidden = direction == .down
                }
                // 动画完成后解锁方向锁，允许下次判断
                DispatchQueue.main.asyncAfter(deadline: .now() + 0.3) {
                    self.directionLock = nil
                }
            }
    }
}

struct ScrollOffsetKey: PreferenceKey {
    static var defaultValue: CGFloat = 0
    static func reduce(value: inout CGFloat, nextValue: () -> CGFloat) {
        value = nextValue()
    }
}

2. 偏移量平滑处理（可选）

如果仍存在微小波动问题，可以对连续的偏移量做加权平均，进一步过滤噪声：

@State private var smoothedOffset: CGFloat = 0
private let smoothingFactor: CGFloat = 0.8 // 平滑系数，越接近1越稳定

private func handleScrollOffsetChange(offset: CGFloat) {
    // 加权平均平滑偏移量
    smoothedOffset = smoothedOffset * smoothingFactor + offset * (1 - smoothingFactor)
    let offsetDiff = smoothedOffset - lastOffset
    
    // 后续逻辑同上...
    lastOffset = smoothedOffset
}

关键优化点说明 #

• 方向锁定：一旦触发某个方向的状态变化，锁定该方向，直到反向滚动超过设定阈值才允许切换，避免慢速拖动时的频繁反转。
• 防抖延迟：通过Combine的delay操作符，延迟状态更新，过滤短时间内的偏移波动，确保只有稳定的滚动动作才会触发动画。
• 微小偏移过滤：忽略1pt以内的偏移变化，过滤滚动时的自然抖动噪声。
• 动画原子性：在动画执行期间锁定方向，避免叠加动画导致的卡顿。

内容的提问来源于stack exchange，提问作者Shawn Frank