如何使用TextKit 2在NSTextView中实现可点击文本链接化？

你的问题核心在于：仅通过NSAttributedString.Key.link属性添加视觉样式，无法触发TextKit 2的交互逻辑——TextKit 2需要使用**原生文本元素NSTextLink**来识别可交互链接，而非仅依赖旧的属性标记。下面是基于NSTextContentStorageDelegate的高效实现方案：

核心修改：用NSTextLink替代纯属性标记 #

NSTextLink是TextKit 2专为可交互链接设计的文本元素，系统会自动识别它并处理光标样式、点击跳转等交互逻辑。修改你的代理方法如下：

func textContentStorage(_ textContentStorage: NSTextContentStorage, textParagraphWith range: NSRange) -> NSTextParagraph? {
    let originalText = textContentStorage.textStorage!.attributedSubstring(from: range)
    let mutableText = NSMutableAttributedString(attributedString: originalText)
    let detector = try! NSDataDetector(types: NSTextCheckingResult.CheckingType.link.rawValue)
    
    // 先收集所有链接范围，避免修改文本时的范围偏移问题
    var linkRanges: [NSRange] = []
    detector.enumerateMatches(in: mutableText.string, options: [], range: NSRange(location: 0, length: mutableText.length)) { match, _, _ in
        if let matchRange = match?.range {
            linkRanges.append(matchRange)
        }
    }
    
    // 从后往前替换链接，防止前面的修改影响后续范围的准确性
    for linkRange in linkRanges.reversed() {
        let linkSubstring = mutableText.attributedSubstring(from: linkRange)
        guard let url = detector.firstMatch(in: linkSubstring.string, range: NSRange(location: 0, length: linkSubstring.length))?.url else {
            continue
        }
        
        // 创建TextKit 2原生链接元素
        let textLink = NSTextLink(url: url)
        // 保留原文本的样式属性，仅替换为链接元素
        let linkAttributedString = NSAttributedString(textElement: textLink, attributes: linkSubstring.attributes(at: 0, effectiveRange: nil))
        
        mutableText.replaceCharacters(in: linkRange, with: linkAttributedString)
    }
    
    return linkRanges.isEmpty ? nil : NSTextParagraph(attributedString: mutableText)
}

关键要点 #

1. 从后往前替换：修改文本时，先处理末尾的链接，避免前面的文本长度变化导致后续范围偏移。
2. NSTextLink包裹：将识别到的链接文本替换为NSTextLink元素，系统会自动为其添加交互能力（指针光标、点击跳转）。
3. 保留原样式：复制原文本的属性到链接元素，确保视觉效果和原文本一致。

必要的文本视图配置 #

确保你的NSTextView满足以下条件：

• isSelectable = true：允许文本被选中，这是链接交互的前提（默认值通常为true）。
• isEditable：根据业务需求设置，即使设为false，链接依然可以交互。

自定义点击行为（可选） #

如果需要替换系统默认的打开URL行为（比如打开应用内页面），实现NSTextViewDelegate的对应方法：

func textView(_ textView: NSTextView, clickedOnLink link: NSTextLink, at characterIndex: Int) -> Bool {
    guard let url = link.url else { return false }
    
    // 自定义处理逻辑，比如打开应用内页面
    // Example:
    // if url.scheme == "myapp" {
    //     AppRouter.open(url)
    // } else {
    //     NSWorkspace.shared.open(url)
    // }
    
    NSWorkspace.shared.open(url)
    return true // 返回true表示已自定义处理，系统不再执行默认逻辑
}

为什么原代码无效？ #

TextKit 2中，NSAttributedString.Key.link仅作为视觉样式标记存在，不会触发系统的交互逻辑。只有NSTextLink这种原生文本元素，才会被TextKit 2识别为可交互组件，自动处理光标切换和点击事件。

这种方案延续了你最初的思路——仅处理变更的段落，充分利用TextKit 2的高效特性，避免全文档扫描的性能问题。

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