UITextInput.characterRange(at:)像素偏移及UITextView子类点击字符获取问题

这个问题我之前也碰到过，核心原因是点击坐标没有正确映射到文本容器的排版坐标，再加上characterRange(at:)方法本身在处理滚动、内边距场景时的精度局限性，才导致了像素偏移。下面给你两个关键修正点和完整的实现代码：

1. 正确转换点击坐标 #

UITapGestureRecognizer返回的坐标是相对于UITextView本身的，但文本的排版是在textContainer内部，还要考虑textView的滚动偏移（contentOffset）和内边距（textContainerInset），必须先把点击坐标转换为textContainer内部的相对坐标才能精准匹配。

2. 使用NSLayoutManager精准定位字符 #

相比UITextInput.characterRange(at:)，NSLayoutManager的characterIndex(for:in:fractionOfDistanceBetweenInsertionPoints:)方法直接基于文本排版布局计算，精度更高，能从根源避免偏移问题。

完整的修正代码 #

把你的textTapped方法替换成下面的实现：

@objc func textTapped(recognizer: UITapGestureRecognizer) {
    // 获取点击在UITextView中的原始位置
    let tapLocation = recognizer.location(in: self)
    
    // 将坐标转换为相对于NSLayoutManager的坐标（对应textContainer的排版区域）
    let layoutLocation = convert(tapLocation, to: layoutManager)
    
    // 利用layoutManager获取精准的字符索引
    let characterIndex = layoutManager.characterIndex(
        for: layoutLocation,
        in: textContainer,
        fractionOfDistanceBetweenInsertionPoints: nil
    )
    
    // 确保索引在文本范围内
    guard let text = self.text, characterIndex < text.count else { return }
    
    // 获取被点击的字符
    let tappedCharacter = text[text.index(text.startIndex, offsetBy: characterIndex)]
    print("点击到的字符：\(tappedCharacter)")
    
    // 如果需要获取字符对应的NSRange（比如用于高亮等操作），可以这样：
    let startPosition = position(from: beginningOfDocument, offset: characterIndex)!
    let endPosition = position(from: startPosition, offset: 1)!
    if let textRange = textRange(from: startPosition, to: endPosition) {
        let nsRange = NSRange(textRange, in: self)
        print("字符的NSRange：\(nsRange)")
    }
}

额外注意事项 #

• 你已经设置了textContainer.lineFragmentPadding = 0和textContainerInset = .zero，这很好，能减少排版偏移的变量；如果后续调整了这些值，也不需要额外修改坐标转换，因为convert(_:to:)方法已经自动考虑了这些布局参数。
• 当textView滚动时，contentOffset会被自动包含在坐标转换中，不需要手动调整。
• 这个方法对多行文本、富文本等复杂排版场景同样适用，因为NSLayoutManager会处理所有排版细节。

内容的提问来源于stack exchange，提问作者Cœur