NSView含NSImage子视图保存为PDF时子视图缺失问题求助

你的核心问题是在drawRect:方法中动态添加子视图，这会导致PDF渲染流程无法正确捕获这些子视图的内容，同时还会造成视图层级的重复创建（drawRect:会被频繁调用）。

解决方案一：将子视图添加逻辑移到视图初始化阶段 #

把添加NSImageView的代码从drawRect:中移出，放到视图的初始化方法（或awakeFromNib，如果是从XIB加载）中，保证子视图只被创建一次，且视图层级稳定：

// 视图初始化方法（代码创建视图时调用）
- (instancetype)initWithFrame:(NSRect)frame {
    self = [super initWithFrame:frame];
    if (self) {
        [self setupBackgroundImageView];
    }
    return self;
}

// XIB加载视图时调用
- (void)awakeFromNib {
    [super awakeFromNib];
    [self setupBackgroundImageView];
}

// 统一设置背景图视图
- (void)setupBackgroundImageView {
    NSImageView *backgroundImageView = [[NSImageView alloc] initWithFrame:self.bounds];
    backgroundImageView.image = _bgImage;
    backgroundImageView.imageScaling = NSImageScaleProportionallyUpOrDown;
    // 适配视图大小变化
    backgroundImageView.autoresizingMask = NSViewWidthSizable | NSViewHeightSizable;
    [self addSubview:backgroundImageView];
}

- (void)drawRect:(NSRect)dirtyRect {
    [super drawRect:dirtyRect];
    
    [[NSColor whiteColor] set];
    NSRectFill(self.bounds);
    // 不再在这里添加子视图
}

解决方案二：直接在drawRect:中绘制NSImage（无需子视图） #

如果不需要NSImageView的交互能力，直接在drawRect:里绘制图片是更轻量的选择，PDF生成时能直接捕获绘制内容：

- (void)drawRect:(NSRect)dirtyRect {
    [super drawRect:dirtyRect];
    
    [[NSColor whiteColor] set];
    NSRectFill(self.bounds);

    [self drawBgImage];
}

- (void)drawBgImage {
    if (!_bgImage) return;
    
    // 计算等比例缩放后的绘制区域
    NSRect imageRect = [self calculateProportionalImageRect:_bgImage containerRect:self.bounds];
    [_bgImage drawInRect:imageRect fromRect:NSZeroRect operation:NSCompositingOperationSourceOver fraction:1.0];
}

// 辅助方法：计算保持比例的图片绘制矩形
- (NSRect)calculateProportionalImageRect:(NSImage *)image containerRect:(NSRect)containerRect {
    NSSize imgSize = image.size;
    CGFloat scale = MIN(containerRect.size.width / imgSize.width, containerRect.size.height / imgSize.height);
    NSSize scaledSize = NSMakeSize(imgSize.width * scale, imgSize.height * scale);
    
    return NSMakeRect(
        containerRect.origin.x + (containerRect.size.width - scaledSize.width)/2,
        containerRect.origin.y + (containerRect.size.height - scaledSize.height)/2,
        scaledSize.width,
        scaledSize.height
    );
}

为什么原代码会失效？ #

drawRect:是系统通知视图绘制自身内容的回调，会被频繁触发（比如窗口大小变化、视图刷新时）。在这个方法里添加子视图会重复创建大量相同的视图，而且PDF生成的dataWithPDFInsideRect:流程和屏幕即时渲染不同——动态添加的子视图可能还没完成布局和绘制，就被PDF捕获流程跳过了，导致PDF中无法显示这些子视图。

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