macOS切换系统外观时自定义NSView语义颜色不跟随变化如何解决？

修复方案 #

完整可运行代码

@IBDesignable class ColoredView: NSView {
    @IBInspectable var backgroundColor: NSColor = .clear {
        didSet {
            needsDisplay = true
        }
    }
    
    @IBInspectable var cornerRadius: CGFloat = 4 {
        didSet {
            layer?.cornerRadius = cornerRadius
        }
    }
    
    override var wantsLayer: Bool {
        get { true }
        set {}
    }
    
    override init(frame frameRect: NSRect) {
        super.init(frame: frameRect)
        commonSetup()
    }
    
    required init?(coder: NSCoder) {
        super.init(coder: coder)
        commonSetup()
    }
    
    private func commonSetup() {
        layer?.cornerRadius = cornerRadius
        needsDisplayOnBoundsChange = true
    }
    
    override func draw(_ dirtyRect: NSRect) {
        super.draw(dirtyRect)
        backgroundColor.setFill()
        dirtyRect.fill(using: .sourceOver)
    }
    
    override func prepareForInterfaceBuilder() {
        super.prepareForInterfaceBuilder()
        #if TARGET_INTERFACE_BUILDER
        if backgroundColor.type == .dynamic {
            backgroundColor = backgroundColor.resolvedColor(for: effectiveAppearance)
        }
        #endif
    }
}

关键修改说明

• 强制开启layer-backed视图：重写wantsLayer返回true，避免layer属性为空导致圆角设置不生效、逻辑异常。
• 属性变更触发重绘：给backgroundColor、cornerRadius添加didSet回调，属性修改后立即触发UI更新，无需等待系统被动回调。
• 自动响应外观变化：设置needsDisplay = true和needsDisplayOnBoundsChange = true，系统外观切换时会自动触发重绘，动态语义颜色会基于最新的effectiveAppearance重新解析渲染。
• 修复IB设计时崩溃：在prepareForInterfaceBuilder中做设计时兼容，动态颜色在IB环境下提前解析为静态色，避免自定义语义色加载异常导致的崩溃。

额外注意事项

切换主题的代码建议放在主队列执行，避免线程问题导致更新不生效，如果需要全局生效可以直接设置NSApp的外观：

DispatchQueue.main.async {
    // 全局生效
    NSApp.appearance = NSAppearance(named: .darkAqua)
    // 仅当前窗口生效
    // NSApplication.shared.mainWindow?.appearance = NSAppearance(named: .darkAqua)
}

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