如何解决NSTextView替换文本后自动滚动到顶部且无闪烁的问题

原有方案出现闪烁的核心原因：使用dispatch_async将滚动回退操作延迟到下一个runloop周期执行，系统会先渲染出文本更新后自动滚动到顶部的画面，再渲染滚动回退的画面，两次帧渲染跳变产生闪烁；直接修改stringValue会触发NSTextView默认的滚动到顶部行为。

方案1：同帧同步处理（适配绝大多数场景，优先使用） #

去掉异步调度，所有操作在同一个runloop周期内完成，同时禁用滚动动画，避免中间态被渲染出来：

// 记录更新前的滚动偏移
CGFloat oldOffset = self.scrollView.documentVisibleRect.origin.y;

// 临时禁用滚动动画
[NSAnimationContext runAnimationGroup:^(NSAnimationContext * _Nonnull context) {
    context.duration = 0;
    context.allowsImplicitAnimation = NO;
} completionHandler:nil];

// 更新文本内容（如果使用binding直接赋值self.newText即可）
self.textView.string = newText;

// 计算新的最大合法偏移，避免滚动超出边界
CGFloat newDocHeight = self.scrollView.documentView.bounds.size.height;
CGFloat maxAllowedOffset = MAX(0, newDocHeight - self.scrollView.bounds.size.height);
CGFloat targetOffset = MIN(oldOffset, maxAllowedOffset);

// 同步设置滚动偏移，立即生效
[self.scrollView.contentView scrollToPoint:CGPointMake(0, targetOffset)];
[self.scrollView reflectScrolledClipView:self.scrollView.contentView];

方案2：锁住屏幕更新（适配渲染逻辑复杂的场景） #

如果方案1仍有轻微闪烁，可以用系统提供的屏幕更新锁，将文本替换和滚动操作合并为单次渲染：

// 禁用屏幕更新，直到主动解锁前所有视图变化都不会被渲染
NSDisableScreenUpdates();

CGFloat oldOffset = self.scrollView.documentVisibleRect.origin.y;
self.newText = newText; // 走binding更新文本也可

CGFloat maxAllowedOffset = MAX(0, self.scrollView.documentView.frame.size.height - self.scrollView.bounds.size.height);
[self.scrollView.contentView scrollToPoint:CGPointMake(0, MIN(oldOffset, maxAllowedOffset))];
[self.scrollView displayIfNeeded];

// 解锁屏幕更新，所有变化一次性渲染
NSEnableScreenUpdates();

方案3：按字符位置保留浏览位置（适配内容长度变化大的场景） #

如果全量替换后文本长度变化很大，固定Y偏移会导致用户正在浏览的内容错位，可以改用记录顶部可见字符位置的方式，准确保留用户浏览位置：

// 更新前记录当前可视区域最顶部的字符索引
NSRange visibleRange = [self.textView characterRangeForRect:self.scrollView.documentVisibleRect];
NSUInteger topVisibleCharIndex = visibleRange.location;

// 更新文本
self.textView.string = newText;

// 边界兼容：如果新文本长度比之前记录的索引小，就滚动到最底部
if (topVisibleCharIndex >= self.textView.string.length) {
    CGFloat maxOffset = MAX(0, self.scrollView.documentView.frame.size.height - self.scrollView.bounds.size.height);
    [self.scrollView.contentView scrollToPoint:CGPointMake(0, maxOffset)];
} else {
    // 计算之前记录的字符位置的坐标，滚动到对应位置
    NSRect targetCharRect = [self.textView firstRectForCharacterRange:NSMakeRange(topVisibleCharIndex, 1)];
    [self.scrollView.contentView scrollToPoint:CGPointMake(0, targetCharRect.origin.y)];
}
[self.scrollView reflectScrolledClipView:self.scrollView.contentView];

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