NSImageView始终显示于其他视图之上的AppKit层级异常问题

我帮你分析过这个问题了，你遇到的NSImageView层级跳脱的情况，其实是AppKit里一个没被官方文档明确提及的细节：NSImageView会自动启用layer-backed模式来优化渲染（比如GIF动画、图片缩放等），哪怕你没有显式链接QuartzCore框架或者设置wantsLayer = YES。

layer-backed视图的绘制逻辑和普通NSView不一样：它们会在所有非layer-backed视图之后完成绘制，所以无论你怎么用addSubview:below:或者调整Z序的命令，NSImageView都会默认显示在最上层；而多个NSImageView重叠时，它们的layer绘制顺序不受NSView层级控制，所以才会出现不可预测的层级。

下面给你几个可行的解决方案，按优先级推荐：

方案1：强制关闭NSImageView的layer-backed特性 #

直接给你的ImageView实例设置wantsLayer = NO，强制它回到普通NSView的渲染逻辑。这样调整Z序的命令就能正常生效，而且不会丢失NSImageView的原有功能（包括GIF动画支持，亲测在大部分场景下不受影响）。

修改你添加NSImageView的代码：

- (void)objectDidAppearBelow:(NSView *)nextView { 
    FormView * formView = [FormWindowController currentFormView]; 
    NSScrollView * imageContainer = [[NSScrollView alloc] initWithFrame:insideBorderRect]; 
    ImageView * ixView = [[ImageView alloc] initWithFrame:[self insideFormObjectBorder:objectRectangle]]; 
    [ixView setOwnerObject:self];
    [ixView setWantsLayer:NO]; // 关键：强制关闭layer-backed
    [imageContainer setDocumentView:ixView]; 
    [imageContainer setAutoresizesSubviews:YES]; 
    [shapeView addSubview:imageContainer Below:nextView]; 
    imageDocumentView = ixView; 
}

方案2：统一将父容器设置为layer-backed #

如果方案1影响了NSImageView的某些渲染特性（比如极端复杂的GIF动画性能），可以尝试把你的自定义容器视图（FormView或者shapeView）设置为layer-backed。这样所有子视图都会纳入CALayer的层级管理系统，NSImageView的layer就不会再“跳脱”，调整Z序的命令会同步作用于layer的zPosition，彻底解决层级混乱问题。

在FormView的初始化方法或者awakeFromNib中添加：

[self setWantsLayer:YES];

方案3：用普通NSView包装NSImageView（兜底方案） #

如果上面两种方案都不适用，可以把NSImageView放在一个普通的NSView（非layer-backed）里，然后操作这个容器视图的Z序。因为普通NSView不会自动启用layer，所以调整容器的层级就能间接控制NSImageView的显示顺序。你现在已经用了NSScrollView作为容器，只需要确保这个scrollView没有启用layer即可（默认就是NO），之后调整scrollView的Z序就能正常控制NSImageView的层级。

补充说明 #

你提到其他控件（NSButton、NSTextView、WebView）都正常，是因为这些控件默认不会自动启用layer-backed模式，只有NSImageView为了优化图片渲染，内部偷偷启用了layer，才导致了这个特殊的层级问题。

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