TextKit NSLayoutManager的boundingRect与UITextView特定字体定位不匹配求助

我需要对UITextView（或其子类）的字形执行动画/变换操作，采用TextKit（NSTextContainer/NSLayoutManager/NSTextStorage）获取指定字形的frame，再通过CATextLayer手动定位每个字形（依赖CoreAnimation保证流畅性）。但针对Courier这类字体，boundingRect(forGlyphRange:, in:)返回的frame和UITextView默认渲染的字形位置存在明显Y轴偏移，导致红色CALayer字形无法和黑色原生字形重合。

核心问题原因 #

boundingRect(forGlyphRange:, in:)返回的是字形的完整排版边界框，包含了字体的ascender（上升高度）、descender（下降高度）、leading（行间距）等全部垂直空间，但UITextView渲染时，字形是基于**基线（baseline）**对齐的，且CATextLayer的默认布局逻辑和TextKit的排版规则存在差异，最终导致偏移。

修正步骤 #

1. 获取准确的基线位置
   用NSLayoutManager的location(forGlyphAt:)方法获取字形的基线起点坐标，这个坐标是相对于textContainer的位置，是UITextView渲染字形的基准点。

2. 结合字体属性计算字形Frame
   通过CTFont（或UIFont的CoreText桥接）获取字体的ascender、descender值，从基线位置向上偏移ascender高度得到字形顶部，向下偏移descender高度得到底部，再结合字形的宽度（用boundingRect的width）得到准确的frame。

3. 匹配CATextLayer与UITextView的布局属性

   • 设置CATextLayer的font为和UITextView完全一致的字体（包括字号、字重）
   • 把alignmentMode设为.left（和UITextView默认对齐方式一致）
   • 关闭usesScreenFonts（避免字体渲染差异）

修改后的Playground代码 #

import UIKit
import PlaygroundSupport

class GlyphAlignmentTestViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        view.backgroundColor = .white
        
        // 1. 创建UITextView作为基准
        let textView = UITextView(frame: CGRect(x: 20, y: 100, width: 300, height: 200))
        textView.text = "Hello Courier World!"
        textView.font = UIFont(name: "Courier", size: 40)
        textView.backgroundColor = .clear
        view.addSubview(textView)
        
        // 2. 初始化TextKit组件
        let textStorage = NSTextStorage(attributedString: textView.attributedText!)
        let layoutManager = NSLayoutManager()
        let textContainer = NSTextContainer(size: textView.bounds.size)
        textContainer.lineFragmentPadding = textView.textContainer.lineFragmentPadding
        textContainer.maximumNumberOfLines = textView.textContainer.maximumNumberOfLines
        textContainer.lineBreakMode = textView.textContainer.lineBreakMode
        
        layoutManager.addTextContainer(textContainer)
        textStorage.addLayoutManager(layoutManager)
        
        // 3. 遍历每个字形，创建对应的CATextLayer
        let glyphCount = layoutManager.numberOfGlyphs
        for glyphIndex in 0..<glyphCount {
            guard layoutManager.isValidGlyphIndex(glyphIndex) else { continue }
            
            // 获取字形的基线位置（相对于textContainer）
            let baselinePoint = layoutManager.location(forGlyphAt: glyphIndex)
            // 获取字形的宽度
            let glyphRange = NSRange(location: glyphIndex, length: 1)
            let glyphBounds = layoutManager.boundingRect(forGlyphRange: glyphRange, in: textContainer)
            let glyphWidth = glyphBounds.width
            
            // 获取字体的CoreText属性
            let font = textView.font!
            let ctFont = CTFontCreateWithName(font.fontName as CFString, font.pointSize, nil)
            let ascender = CTFontGetAscent(ctFont)
            let descender = CTFontGetDescent(ctFont)
            
            // 计算准确的字形Frame（转换到UITextView的坐标系）
            let glyphFrame = CGRect(
                x: baselinePoint.x + textView.textContainerInset.left,
                y: baselinePoint.y - ascender + textView.textContainerInset.top,
                width: glyphWidth,
                height: ascender - descender
            )
            
            // 创建CATextLayer
            let textLayer = CATextLayer()
            textLayer.frame = glyphFrame
            textLayer.string = String(UnicodeScalar(layoutManager.glyph(at: glyphIndex))!)
            textLayer.font = ctFont
            textLayer.fontSize = font.pointSize
            textLayer.alignmentMode = .left
            textLayer.foregroundColor = UIColor.red.cgColor
            textLayer.contentsScale = UIScreen.main.scale
            
            view.layer.addSublayer(textLayer)
        }
    }
}

PlaygroundPage.current.liveView = GlyphAlignmentTestViewController()

关键代码解释 #

• location(forGlyphAt:)：获取字形在textContainer中的基线起点，这是UITextView渲染字形的垂直基准线。
• CTFontGetAscent/CTFontGetDescent：获取字体的上升/下降高度，从基线向上偏移ascender得到字形顶部，向下偏移descender得到底部，确保Frame完全匹配UITextView的渲染范围。
• 匹配textContainer的lineFragmentPadding和UITextView的textContainerInset：这些参数会影响TextKit的排版位置，必须同步才能保证坐标转换准确。

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