在NSTextView中查找子串并滚动至其位置的实现问题

我之前也踩过长文本在NSTextView里定位子串的坑，尤其是Swift字符串索引和AppKit的NSRange不匹配的问题，结合你的场景，给你一套可靠的解决方案：

核心思路 #

NSTextView的文本系统基于UTF-16编码的NSRange，而Swift的String.Index是基于Unicode标量的，直接混用很容易出现索引偏移。所以我们需要先把Swift字符串转换成NSString来获取正确的NSRange，再让NSTextView滚动到该位置。

完整实现代码 #

@IBOutlet weak var logTextView: NSScrollView!
@IBOutlet var logTextBox: NSTextView!

/// 滚动到指定时间戳的位置
/// - Parameter searchString: 要查找的时间戳字符串
func scrollToTargetTimestamp(_ searchString: String) {
    // 先确保文本视图有内容
    guard let fullText = logTextBox.string else {
        print("文本视图为空")
        return
    }
    
    // 转换为NSString，直接获取NSRange（适配AppKit的文本系统）
    let nsFullText = fullText as NSString
    let targetRange = nsFullText.range(of: searchString)
    
    // 检查是否找到目标子串
    guard targetRange.location != NSNotFound else {
        print("未找到指定的时间戳：\(searchString)")
        return
    }
    
    // 滚动到目标范围，确保内容可见
    logTextBox.scrollRangeToVisible(targetRange)
    
    // 可选：自动选中目标子串，方便用户快速定位
    logTextBox.setSelectedRange(targetRange)
}

// 使用示例
let targetTimestamp = "2018-03-29 10:15:30"
scrollToTargetTimestamp(targetTimestamp)

针对长文本的优化建议 #

你的文本有15MB，要是需要频繁搜索或者匹配多个符合格式的时间戳，用正则表达式会更高效精准（避免误匹配类似字符串），比如匹配yyyy-MM-dd格式的时间戳：

/// 滚动到第一个符合格式的时间戳位置
func scrollToFirstValidTimestamp() {
    guard let fullText = logTextBox.string else { return }
    
    // 时间戳正则表达式（可根据你的实际格式调整）
    let timestampPattern = "\\d{4}-\\d{2}-\\d{2}"
    guard let regex = try? NSRegularExpression(pattern: timestampPattern) else {
        print("正则表达式格式错误")
        return
    }
    
    let nsFullText = fullText as NSString
    let allMatches = regex.matches(
        in: fullText,
        range: NSRange(location: 0, length: nsFullText.length)
    )
    
    guard let firstMatch = allMatches.first else {
        print("未找到任何时间戳")
        return
    }
    
    let matchRange = firstMatch.range
    logTextBox.scrollRangeToVisible(matchRange)
    logTextBox.setSelectedRange(matchRange)
}

关键注意点 #

1. 索引匹配问题：一定要用NSString的range(of:)获取NSRange，直接用Swift的String.range(of:)得到的Range<String.Index>转换到NSRange很容易出错，尤其是长文本包含多字节字符时。
2. 滚动可靠性：scrollRangeToVisible(_:)会自动调整滚动视图的位置，确保目标范围完全可见，不需要手动计算滚动偏移量。
3. 性能：15MB的文本用NSString.range(of:)或者NSRegularExpression都能保持不错的性能，不会有明显卡顿。

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