全角标点引发iOS文本尺寸计算与绘制不一致问题

问题说明 #

需要从长文本中提取适配指定容器尺寸的内容，保证iOS各版本显示一致。但使用layoutManager.enumerateLineFragments逐行分割文本时，若行尾包含全角字符或词组，iOS17的UI组件会强制换行，而TextKit判定该行可完整显示，导致分割结果与UI显示不符；iOS16则无此差异。

已尝试无效方案 #

• 调整NSLayoutManager的lineFragmentPadding，对换行问题无改善；
• 将NSLayoutManager.lineBreakMode改为.byCharWrapping，未解决问题；
• 设置paragraphStyle.lineBreakStrategy为.pushOut，仅适配无全角字符的场景，存在全角字符时仍不一致。

解决方案 #

iOS17对CJK文本的换行规则做了更新，SwiftUI的文本组件默认启用了更严格的排版策略，需让TextKit完全匹配这些规则：

1. 同步排版属性：确保TextKit的字体、行间距、换行策略、内边距与SwiftUI组件完全一致；
2. 使用准确的字符范围转换：避免直接将glyph范围映射为字符范围，改用layoutManager.characterRange(forGlyphRange:actualGlyphRange:)保证准确性；
3. 限制文本容器的显示范围：通过计算容器内能容纳的最大字符范围，而非枚举所有行片段，来匹配UI的显示逻辑。

修改后的代码 #

import SwiftUI

struct SplitTextDemo: View {
    let fontSize: CGFloat = 14
    let containerSize: CGSize = CGSize(width: 300, height: 100)
    
    @State var contentString: String = "18、在一个提示中多次重复某个特定的词短语。\n\n测试文案是否会发生偏移，查看具体位置和文末。iOS16则不会有这个问题，换行和分割是完全一样，但在iOS17中则会出现显示和textkit裁切不一致的情况。"
    @State var splitString: String = ""
    
    var body: some View {
        VStack {
            Text("Original text:")
            TextField("", text: $contentString, axis: .vertical)
                .font(.system(size: fontSize))
                .frame(width: containerSize.width)
                .background {
                    Color.blue
                }
            
            Text("Extracted text:")
            TextField("", text: $splitString, axis: .vertical)
                .font(.system(size: fontSize))
                .frame(width: containerSize.width, height: containerSize.height)
                .background {
                    Color.orange
                }
        }
        .onChange(of: contentString, perform: { value in
            splitString = splitTextToFitContainer(text: contentString, fontSize: fontSize, containerSize: containerSize)
        })
    }
    
    func splitTextToFitContainer(text: String, fontSize: CGFloat, containerSize: CGSize) -> String {
        // 配置与SwiftUI完全一致的排版属性
        let paragraphStyle = NSMutableParagraphStyle()
        paragraphStyle.lineSpacing = 6
        // 使用iOS17默认的标准换行策略，匹配SwiftUI组件
        paragraphStyle.lineBreakStrategy = .standard
        
        let attributes: [NSAttributedString.Key: Any] = [
            .font: UIFont.systemFont(ofSize: fontSize),
            .paragraphStyle: paragraphStyle
        ]
        let attributedText = NSAttributedString(string: text, attributes: attributes)
        
        let layoutManager = NSLayoutManager()
        let textStorage = NSTextStorage(attributedString: attributedText)
        textStorage.addLayoutManager(layoutManager)
        
        // 配置文本容器，内边距与SwiftUI保持一致（默认Text/TextField的内边距为0）
        let textContainer = NSTextContainer(size: containerSize)
        textContainer.lineBreakMode = .byCharWrapping
        textContainer.lineFragmentPadding = 0 // 移除额外内边距，匹配SwiftUI
        layoutManager.addTextContainer(textContainer)
        
        // 确保布局完成
        layoutManager.ensureLayout(for: textContainer)
        
        // 获取容器内能容纳的最大glyph范围
        let visibleGlyphRange = layoutManager.glyphRange(forBoundingRect: CGRect(origin: .zero, size: containerSize), in: textContainer)
        // 将glyph范围转换为准确的字符范围
        var actualGlyphRange = NSRange()
        let characterRange = layoutManager.characterRange(forGlyphRange: visibleGlyphRange, actualGlyphRange: &actualGlyphRange)
        
        guard let stringRange = Range(characterRange, in: text) else {
            return ""
        }
        return String(text[stringRange])
    }
}

#Preview {
    SplitTextDemo()
}

代码说明 #

• 更换lineBreakStrategy为.standard，该策略在iOS17中包含了针对CJK文本的行尾标点换行优化，与SwiftUI组件的默认行为对齐；
• 将textContainer.lineFragmentPadding设为0，匹配SwiftUI文本组件的默认内边距；
• 使用layoutManager.glyphRange(forBoundingRect:)直接计算容器内能显示的glyph范围，再转换为字符范围，避免逐行枚举的误差；
• 通过characterRange(forGlyphRange:actualGlyphRange:)处理glyph与字符的非一一对应场景（如复杂字符、emoji），保证范围转换的准确性。

内容的提问来源于stack exchange，提问作者Z.hack