NSToolbarItem图片在Interface Builder显示正常但运行应用时缩小效果差

问题原因 #

• Xcode默认PDF资源编译逻辑：你在Asset Catalog中导入PDF素材时如果未开启Preserve Vector Data选项，Xcode会在编译阶段将PDF转换为固定分辨率的PNG位图，运行时对该位图做缩小处理时默认调用低性能采样算法，会丢失大量细节。
• 缩放算法差异：Interface Builder的预览界面使用Quartz框架的高质量缩小采样算法（如Lanczos），而App运行时默认对NSImage采用速度优先的双线性采样，对细节丰富的小尺寸图标影响格外明显。
• 视网膜屏适配缺失：如果仅导入单张1x分辨率的高分辨率PNG原图，没有提供对应2x/3x倍率的切图，系统在适配不同分辨率屏幕的缩放过程中也会出现细节丢失的问题。

优化方案 #

针对PDF矢量素材 #

• 打开Asset Catalog，选中所有PDF资源，在右侧属性检查器中勾选Preserve Vector Data选项，Xcode编译时会保留矢量数据，运行时直接根据显示尺寸渲染，缩放不会损失清晰度。
• 矢量资源的Scales属性保持默认Single Scale即可，无需设置多倍率。

针对PNG位图素材（如MacPaint图标） #

• 优先提供对应NSToolbar图标尺寸的多倍率切图：常规NSToolbar图标尺寸为32x32pt，你需要提前准备1x（32x32px）、2x（64x64px）、3x（96x96px）三个版本的PNG导入Asset Catalog，从根源避免系统运行时缩放。
• 如果必须使用单张大图动态缩放，可以在代码中手动指定高质量采样算法生成目标尺寸的图标，示例代码如下：
  Objective-C版本：

NSImage *originalImg = [NSImage imageNamed:@"ExportMacPaint"];
NSSize targetSize = NSMakeSize(32, 32); // 替换为实际需要的图标尺寸
NSImage *resizedImg = [[NSImage alloc] initWithSize:targetSize];
[resizedImg lockFocus];
[NSGraphicsContext.currentContext setImageInterpolation:NSImageInterpolationHigh];
[originalImg drawInRect:NSMakeRect(0, 0, targetSize.width, targetSize.height) fromRect:NSZeroRect operation:NSCompositingOperationCopy fraction:1.0];
[resizedImg unlockFocus];
toolbarItem.image = resizedImg;

Swift版本：

guard let originalImg = NSImage(named: "ExportMacPaint") else { return }
let targetSize = NSSize(width: 32, height: 32)
let resizedImg = NSImage(size: targetSize)
resizedImg.lockFocus()
NSGraphicsContext.current?.imageInterpolation = .high
originalImg.draw(in: NSRect(origin: .zero, size: targetSize), from: .zero, operation: .copy, fraction: 1.0)
resizedImg.unlockFocus()
toolbarItem.image = resizedImg

• 也可以提前用设计工具（Photoshop、Sketch等）将原图缩小到目标尺寸，手动做锐化优化后再导入Xcode，显示效果会优于系统自动缩放的结果。

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