NSTextView文本高亮视觉故障：末尾竖白线问题排查与解决

问题重现 #

你在NSTextView中通过NSLayoutManager的addTemporaryAttribute方法给部分文本设置自定义背景色和前景色后，发现前景色范围的末尾出现了一条细垂直白线。你的代码如下：

guard let textStorage = textView.textStorage else { return }
let str = """
var invariant = require('fbjs/lib/invariant');
var warning = require('fbjs/lib/warning');
"""
let attrStr = NSAttributedString(string: str, attributes: [.font: NSFont(name: "Menlo", size: 11.0)!] )
textStorage.setAttributedString(attrStr)
for layoutManager in textStorage.layoutManagers {
    layoutManager.addTemporaryAttribute(.backgroundColor, value: NSColor.darkGray, forCharacterRange: NSRange(location: 47, length: 43))
    layoutManager.addTemporaryAttribute(.foregroundColor, value: NSColor.red, forCharacterRange: NSRange(location: 69, length: 18))
}

原因分析 #

这条烦人的白线本质是NSLayoutManager绘制临时属性时的渲染边界/像素对齐问题：

• 临时属性是在LayoutManager的绘制阶段叠加渲染的，和NSTextStorage中存储的常规属性相比，它的边缘处理逻辑没有那么严谨。
• 当你的前景色范围刚好落在某个字符的字形边缘时，由于字符的字形轮廓和屏幕像素网格不完全对齐，渲染时会出现一个细微的缝隙——背景色（这里是深灰色）从前景色（红色）的边缘透出来，看起来就是那条垂直白线。

解决方法 #

这里有几种实用的修复方案，按复杂度从低到高排列：

1. 微调高亮范围（最简单快速）

只需要把前景色的范围长度增加1，让它稍微覆盖过原本的边界，就能填补那个缝隙：

// 将length从18改为19，或者微调location让范围覆盖到下一个字符的起始位置
layoutManager.addTemporaryAttribute(.foregroundColor, value: NSColor.red, forCharacterRange: NSRange(location: 69, length: 19))

这种方法不需要改动整体逻辑，适合快速修复场景。

2. 使用常规属性替代临时属性（更稳定）

如果你的高亮不需要动态频繁切换（比如不需要临时展示后快速移除），直接在NSTextStorage上设置属性是更稳妥的选择——常规属性的渲染逻辑经过优化，不会出现这类边界问题：

guard let textStorage = textView.textStorage else { return }
let str = """
var invariant = require('fbjs/lib/invariant');
var warning = require('fbjs/lib/warning');
"""
// 先创建带基础样式的可变属性字符串
let baseAttributes: [NSAttributedString.Key: Any] = [
    .font: NSFont(name: "Menlo", size: 11.0)!
]
let mutableAttrStr = NSMutableAttributedString(string: str, attributes: baseAttributes)

// 设置背景色
mutableAttrStr.addAttribute(.backgroundColor, value: NSColor.darkGray, range: NSRange(location: 47, length: 43))
// 设置前景色
mutableAttrStr.addAttribute(.foregroundColor, value: NSColor.red, range: NSRange(location: 69, length: 18))

textStorage.setAttributedString(mutableAttrStr)

3. 自定义LayoutManager（进阶方案）

如果必须使用临时属性（比如需要临时高亮后快速清除），可以子类化NSLayoutManager，重写drawGlyphs(forGlyphRange:at:)方法，在绘制临时属性的边缘时手动处理像素对齐，强制让前景色的渲染范围覆盖缝隙区域。不过这种方法需要对TextKit的渲染流程有一定了解，适合高度自定义的场景。

验证效果 #

按照上面的方法修改后，重新运行代码，那条垂直白线应该就会消失了——要么是通过扩大范围填补了缝隙，要么是用更完善的常规属性渲染逻辑避免了边界问题。

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