Swift中UITextDocumentProxy的documentContextAfterInput无法返回光标后完整文本

核心原因与API限制 #

1. 为何仅返回当前行文本？ #

documentContextAfterInput的设计目标是为键盘提供光标所在段落内的后续文本，而非整个文档的全部内容。iOS文本系统以段落为单位组织内容，宿主App（如短信、备忘录）通常仅会向键盘暴露当前段落的上下文，不会返回跨段落的文本。

2. UITextDocumentProxy的隐藏限制 #

• API定位限制：该API是为输入补全、纠错等即时键盘功能设计，并非用于完整文档读取，因此天然存在段落边界的限制。
• 宿主App权限控制：部分App会限制键盘可读取的文本范围，避免敏感信息泄露，跨段落的文本可能被刻意屏蔽。
• 光标移动计算错误：你的代码中用nextContext.lengthOfBytes(using: .utf8)作为偏移量是错误的——adjustTextPosition(byCharacterOffset:)接收的是字符数量，而非字节数。多字节字符（如emoji、中文）会导致光标移动偏移，无法进入下一段，自然读不到后续内容。

解决与调试方案 #

1. 修正光标偏移量计算 #

这是最关键的修复点，将代码中的偏移量计算从字节数改为字符数：

// 错误写法
// textProxy.adjustTextPosition(byCharacterOffset: nextContext.lengthOfBytes(using: .utf8))

// 正确写法
textProxy.adjustTextPosition(byCharacterOffset: nextContext.count)

2. 优化上下文更新等待逻辑 #

固定时长的Task.sleep无法适配所有宿主App的响应速度，改用RunLoop等待更可靠：

// 替代Task.sleep，等待宿主App更新上下文
RunLoop.current.run(until: Date().addingTimeInterval(0.05))

3. 优化逐段读取循环 #

调整读取逻辑，主动处理换行符，尝试跨段落读取：

var forwardContext = ""
while let nextContext = textProxy.documentContextAfterInput, !nextContext.isEmpty {
    forwardContext += nextContext
    // 移动光标到当前段末尾
    textProxy.adjustTextPosition(byCharacterOffset: nextContext.count)
    // 等待上下文更新
    RunLoop.current.run(until: Date().addingTimeInterval(0.05))
    
    // 若当前段包含换行，尝试读取下一段
    if nextContext.contains("\n") {
        continue
    }
}

4. 多宿主App测试验证 #

不同App的文本系统实现差异极大，比如备忘录和微信的段落处理逻辑不同，建议在多个主流App中测试，确认是否是特定App的限制导致无法读取跨段落文本。

5. 调整功能预期 #

需要明确：UITextDocumentProxy没有提供读取完整文档的官方API，键盘扩展的文本读取能力受宿主App严格限制。如果必须读取完整文档，可能需要考虑其他方案（如引导用户复制文本到键盘），但这会影响用户体验。

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