问题背景 #

macOS Tahoe支持为文件夹图标添加渐变色着色、保留局部无颜色区域，还可叠加蒙版图标或表情符号。但使用NSWorkspace iconForFile:、NSURLEffectiveIconKey、NSURLCustomIconKey这类常规Cocoa API时，只能获取到默认文件夹图标，无法拿到包含所有自定义视觉效果的完整图标。

解决方案 #

要获取包含全部自定义效果的完整图标，需借助QLThumbnailGenerator框架，它能精准还原Finder中显示的自定义图标渲染效果。

Objective-C 示例代码 #

#import <QuickLook/QuickLook.h>

- (void)fetchFullCustomFolderIcon:(NSURL *)folderURL completion:(void(^)(NSImage * _Nullable icon))completion {
    QLThumbnailGenerator *generator = [QLThumbnailGenerator sharedGenerator];
    QLThumbnailRequest *request = [[QLThumbnailRequest alloc] initWithFileURL:folderURL
                                                                         size:NSMakeSize(512, 512) // 按需调整图标尺寸
                                                                        scale:[NSScreen mainScreen].backingScaleFactor
                                                          representationTypes:QLThumbnailRepresentationTypeIcon];
    
    [generator generateBestRepresentationForRequest:request completionHandler:^(QLThumbnailRepresentation * _Nullable representation, NSError * _Nullable error) {
        if (representation) {
            completion(representation.NSImage);
        } else {
            completion(nil);
        }
    }];
}

关键说明 #

• QLThumbnailGenerator会模拟Finder的渲染逻辑，完整还原渐变着色、覆盖层等所有系统层面的自定义视觉修饰。
• 项目需引入QuickLook框架才能使用该API。
• 通过调整size参数可获取不同尺寸的图标，使用主屏幕缩放因子scale能保证图标清晰度。

常规API失效原因 #

• NSURLCustomIconKey仅返回用户手动设置的自定义图标文件（若存在），而Tahoe的文件夹渐变着色、覆盖层属于系统动态渲染效果，并非存储为独立的自定义图标文件。
• NSURLEffectiveIconKey和NSWorkspace iconForFile:仅返回基础图标，不会包含这些动态生成的视觉修饰。

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