Mac Spotlight为自定义UTType文档显示默认图标问题排查

我正在开发一款macOS应用，自定义了.artcl后缀的文档类型，已在Info.plist中配置了对应的Document Type和Exported Type Identifier，Finder能正常识别该后缀文件并显示自定义图标，但通过手动代码将文档添加到Spotlight索引后，搜索结果里的文档显示默认空白图标，索引功能本身正常，Spotlight能找到这些文档。

索引代码 #

var searchableItems: [CSSearchableItem] = []
let myType = UTType(filenameExtension: "artcl")!
let attributeSet = CSSearchableItemAttributeSet(contentType: myType)
attributeSet.title = article.title
attributeSet.contentDescription = article.short
attributeSet.displayName = article.title
attributeSet.keywords = [ "artcl", article.keyword ]
attributeSet.comment = article.short
attributeSet.contentType = "com.deva.testspot.artcl"

let id = "artcl." + article.language + "." + article.title
let indexItem = CSSearchableItem(uniqueIdentifier: id, domainIdentifier: "artcl", attributeSet: attributeSet)
searchableItems.append(indexItem)

let defaultIndex = CSSearchableIndex(name: "Testspot")
defaultIndex.deleteAllSearchableItems()
defaultIndex.beginBatch()
    
defaultIndex.indexSearchableItems(searchableItems)
defaultIndex.endBatch(withClientState: clientData) { error in
    if error != nil {
        print(error?.localizedDescription ?? "Unknown error")
    } else {
        print("Item indexed.")
    }
}

Info.plist的Document Type配置 #

• Name：自定义名称（如Article）
• Types：com.deva.testspot.artcl
• Icon File：指定了自定义图标文件
• Role：Editor
• Bundle Type：Document
• Extension：artcl

1. 完善UTType的Info.plist配置 #

在Exported Type Identifier节点下，确保补充以下配置：

• 添加UTTypeIconFile，值为你的图标文件名（不带.icns后缀）
• 设置UTTypeConformsTo为合适的父类型（如public.data或public.text）
• 确认UTTypeTagSpecification中正确关联了public.filename-extension为artcl

2. 为搜索属性集显式设置图标 #

Spotlight不会自动复用Finder的图标，需在CSSearchableItemAttributeSet中手动指定：

// 方式1：设置图标文件URL
if let iconURL = Bundle.main.url(forResource: "ArtclIcon", withExtension: "icns") {
    attributeSet.thumbnailURL = iconURL
}

// 方式2：设置图标数据
if let iconData = Bundle.main.url(forResource: "ArtclIcon", withExtension: "icns").flatMap({ try? Data(contentsOf: $0) }) {
    attributeSet.thumbnailData = iconData
}

3. 修正代码中重复的ContentType赋值 #

代码中先通过UTType初始化属性集，又手动赋值字符串类型的ContentType，这会导致冲突，移除手动赋值的行：

// 移除这行代码
// attributeSet.contentType = "com.deva.testspot.artcl"

4. 重置Spotlight索引（调试用） #

修改配置后如果图标仍不显示，可强制Spotlight重新索引：

1. 打开「系统设置」-「Siri与 Spotlight」-「Spotlight隐私设置」
2. 添加应用所在文件夹，等待几秒后再移除
3. 等待Spotlight完成重新索引

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