NSLayoutManager重生成字形后如何校准caret（插入点）的显示位置

你遇到的问题核心是NSLayoutManager的字形生成、排版布局、屏幕渲染是三个独立阶段，ensureGlyphsForCharacterRange仅能保证字形生成完成，不会等待布局和渲染流程结束，直接调用插入点更新方法拿到的还是旧布局的位置参数。

修正步骤 #

1. 新增一个布尔标记位，用来标记是否需要在布局完成后校准插入点位置：

@property (nonatomic, assign) BOOL needsAdjustInsertionPoint;

2. 优化你现有的hideAndShowMarkup方法，不需要手动调用ensureGlyphsForCharacterRange，系统收到字形失效通知后会自动触发布局流程，手动调用反而可能打乱内部布局队列：

-(void)hideAndShowMarkup {
    self.needsAdjustInsertionPoint = YES;
    [self.layoutManager invalidateGlyphsForCharacterRange:currentLine.range changeInLength:0 actualCharacterRange:nil];
    [self.layoutManager invalidateGlyphsForCharacterRange:prevLine.range changeInLength:0 actualCharacterRange:nil];
}

3. 在NSLayoutManagerDelegate的layoutManager:didCompleteLayoutForTextContainer:atEnd:方法中处理校准逻辑，注意三个判断条件：布局是否全部完成、是否是当前文本视图对应的textContainer、是否有校准需求，同时要把校准逻辑扔到主队列下一个RunLoop周期执行，避免在布局上下文内直接修改视图状态触发循环布局：

- (void)layoutManager:(NSLayoutManager *)layoutManager didCompleteLayoutForTextContainer:(NSTextContainer *)textContainer atEnd:(BOOL)layoutFinishedFlag {
    // 仅当本次布局完全结束、是当前使用的文本容器、有校准需求时才执行操作
    if (layoutFinishedFlag && textContainer == self.textView.textContainer && self.needsAdjustInsertionPoint) {
        self.needsAdjustInsertionPoint = NO;
        dispatch_async(dispatch_get_main_queue(), ^{
            // 先重置插入点状态
            [self.textView updateInsertionPointStateAndRestartTimer:YES];
            // 如果仍有偏移，可手动根据最新字形位置校准
            NSRange selection = self.textView.selectedRange;
            if (selection.location != NSNotFound && selection.length == 0) {
                NSUInteger glyphIndex = [self.layoutManager glyphIndexForCharacterAtIndex:selection.location];
                NSPoint glyphOrigin = [self.layoutManager locationForGlyphAtIndex:glyphIndex];
                // 可选：手动更新插入点位置
                [self.textView setInsertionPointRect:NSMakeRect(glyphOrigin.x, glyphOrigin.y, 2, self.textView.font.lineHeight)];
            }
        });
    }
}

常见坑排查 #

如果调整后仍然有偏移，优先检查shouldGenerateGlyphs代理的实现：隐藏标记字符时是否正确处理了字符索引到字形索引的映射关系，不要出现索引错位，否则后续所有位置计算都会出错。

如果以上方案都不满足需求，可以监听NSTextView的NSViewDidDrawNotification通知，同样通过标记位控制只在需要的时候执行校准，不过这个通知触发频率较高，注意做好判断避免性能损耗。

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