如何让任意NSView绘制到图片而非NSWindow，实现渲染顺序控制？

针对你遇到的「图层视图无法拦截绘制」的问题，这里提供一套通用方案，不管目标视图是否基于CALayer，都能实现自定义绘制时机的需求：

核心思路 #

绕过视图自身的绘制逻辑，直接捕获视图的完整渲染结果（包括图层内容），再在内容视图的指定时机将捕获的图像绘制到对应位置，以此实现和内容视图绘制内容的交错融合。

具体实现步骤 #

1. 给NSView添加通用的内容捕获方法 #

通过NSView原生的bitmapImageRepForCachingDisplay(in:)和cacheDisplay(in:to:)方法，统一捕获任意视图的可视内容——这两个方法对图层视图同样有效，因为它们是从NSView层面触发完整渲染，会自动包含底层CALayer的内容：

extension NSView {
    func captureAsImage() -> NSImage? {
        guard let rep = bitmapImageRepForCachingDisplay(in: bounds) else { return nil }
        // 确保视图状态已刷新
        displayIfNeeded()
        cacheDisplay(in: bounds, to: rep)
        
        let image = NSImage(size: bounds.size)
        image.addRepresentation(rep)
        return image
    }
}

2. 缓存视图渲染结果（优化性能） #

如果目标视图状态会频繁变化（比如开关的选中状态、滑块位置），直接在绘制时捕获会有性能损耗，建议添加缓存机制，仅在视图状态变化时更新缓存：

class ContentViewController: NSViewController {
    // 缓存各个目标视图的渲染结果
    private var viewImageCache: [NSView: NSImage] = [:]
    
    override func viewDidLoad() {
        super.viewDidLoad()
        // 给目标视图添加状态监听
        setupUpdateListeners(for: targetSwitchView)
        setupUpdateListeners(for: targetButtonView)
    }
    
    private func setupUpdateListeners(for view: NSView) {
        if let layer = view.layer {
            // 监听图层内容变化
            NotificationCenter.default.addObserver(
                forName: .CALayerContentsDidChange,
                object: layer,
                queue: .main
            ) { [weak self] _ in
                self?.updateCache(for: view)
            }
        } else {
            // 监听非图层视图的frame/内容变化
            view.postsFrameChangedNotifications = true
            NotificationCenter.default.addObserver(
                forName: NSView.frameDidChangeNotification,
                object: view,
                queue: .main
            ) { [weak self] _ in
                self?.updateCache(for: view)
            }
        }
    }
    
    private func updateCache(for view: NSView) {
        viewImageCache[view] = view.captureAsImage()
        // 标记内容视图对应区域需要重绘
        view.setNeedsDisplay(view.frame)
    }
}

3. 在内容视图中自定义绘制顺序 #

重写内容视图的draw(_:)方法，按照你需要的交错顺序，先绘制部分内容，再绘制缓存的视图图像，最后完成剩余内容的绘制：

class CustomContentView: NSView {
    weak var viewCacheProvider: ContentViewController?
    
    override func draw(_ dirtyRect: NSRect) {
        super.draw(dirtyRect)
        
        // 1. 绘制内容视图的第一部分内容
        drawFirstPartOfContent()
        
        // 2. 绘制目标开关视图的缓存图像到指定位置
        if let switchImage = viewCacheProvider?.viewImageCache[targetSwitchView],
           let switchFrame = viewCacheProvider?.targetSwitchView.frame {
            switchImage.draw(in: switchFrame)
        }
        
        // 3. 绘制内容视图的中间部分内容
        drawMiddlePartOfContent()
        
        // 4. 绘制目标按钮视图的缓存图像到指定位置
        if let buttonImage = viewCacheProvider?.viewImageCache[targetButtonView],
           let buttonFrame = viewCacheProvider?.targetButtonView.frame {
            buttonImage.draw(in: buttonFrame)
        }
        
        // 5. 绘制内容视图的最后部分内容
        drawLastPartOfContent()
    }
}

关键注意事项 #

• 确保目标视图的isHidden设为true，避免系统自动绘制原视图，只保留我们手动绘制的缓存图像。
• 对于使用Auto Layout的视图，要在布局完成后（比如viewDidLayout回调中）首次更新缓存，避免捕获到未布局完成的视图内容。
• 如果需要处理高分辨率屏幕，bitmapImageRepForCachingDisplay会自动适配Retina屏幕的缩放比例，无需额外处理。

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