无法重写NSTableViewRow的draw()方法实现NSOutlineView行透明

这种偶发的黑色行问题我之前在做AppKit项目时也踩过坑，大概率是AppKit底层绘制逻辑和自定义视图的状态冲突导致的，咱们来一步步拆解问题和解决办法：

问题根源分析 #

• 当你重写draw(_ dirtyRect: NSRect)但空实现时，相当于打断了NSTableViewRow默认的背景绘制流程，但AppKit底层的视图绘制状态并没有被正确重置。那些随机出现的黑色，其实是视图的默认背景色或者未被清除的绘制缓存残留。
• NSOutlineView的行重用机制也是诱因之一：当行被复用时，之前的绘制状态没有被完全清理，加上空的draw方法，就会出现无规律的黑色行。

可行的解决方案 #

1. 强制清除绘制上下文（最简单直接） #

在你的draw方法开头，先把当前区域填充为透明色，彻底覆盖底层的残留：

override func draw(_ dirtyRect: NSRect) {
    // 先清除dirtyRect区域的所有内容，设置为透明
    NSColor.clear.setFill()
    dirtyRect.fill()
    
    // 这里再添加你需要的自定义绘制逻辑（如果有的话）
}

这样就能确保不管底层状态如何，当前行的绘制区域都会先被重置为透明，避免黑色残留。

2. 改用Layer-Backed视图（更符合现代AppKit实践） #

如果你的自定义行不需要复杂的Core Graphics绘制，推荐把视图改成layer-backed，通过CALayer来控制背景：

override init(frame frameRect: NSRect) {
    super.init(frame: frameRect)
    wantsLayer = true
    layer?.backgroundColor = NSColor.clear.cgColor
}

required init?(coder: NSCoder) {
    super.init(coder: coder)
    wantsLayer = true
    layer?.backgroundColor = NSColor.clear.cgColor
}

这种方式绕开了手动绘制的麻烦，让AppKit的图层系统来处理背景，状态更稳定。

3. 重置行重用时的状态 #

如果必须保留draw方法，一定要在prepareForReuse()里重置视图状态，避免复用旧行的残留：

override func prepareForReuse() {
    super.prepareForReuse()
    // 重置背景色等可能影响绘制的属性
    self.backgroundColor = .clear
    // 如果有其他自定义绘制状态，也要在这里重置
}

额外检查点 #

• 确认NSOutlineView没有开启alternatingRowBackgrounds，这个属性会和自定义行的背景绘制产生冲突；
• 检查行高设置是否正常，异常的行高可能导致绘制区域计算错误，出现黑色块。

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