如何让macOS Finder显示与应用关联的自定义文档图标？

我已成功创建UTIs，Finder可识别文件归属于我的应用且为特定类型（如ITC Data File），但无法让系统使用我在Xcode属性列表文件中指定的自定义图标。

plist文件相关配置 #

<key>CFBundleDocumentTypes</key>
<array>
    <dict>
        <key>CFBundleTypeExtensions</key>
        <array>
            <string>itc</string>
            <string>vpitc</string>
            <string>ITC</string>
        </array>
        <key>CFBundleTypeIconFile</key>
        <string>DataFileBackground</string>
        <key>CFBundleTypeIconSystemGenerated</key>
        <integer>0</integer>
        <key>CFBundleTypeName</key>
        <string>ITC Data File</string>
        <key>CFBundleTypeRole</key>
        <string>Viewer</string>
        <key>LSHandlerRank</key>
        <string>Default</string>
        <key>LSItemContentTypes</key>
        <array>
            <string>public.itcdatafile</string>
        </array>
        <key>NSDocumentClass</key>
        <string></string>
    </dict>
    <dict>
        <key>CFBundleTypeExtensions</key>
        <array>
            <string>ftitc</string>
            <string>FTITC</string>
        </array>
        <key>CFBundleTypeIconFile</key>
        <string>ProjectFileIcon</string>
        <key>CFBundleTypeIconSystemGenerated</key>
        <integer>0</integer>
        <key>CFBundleTypeName</key>
        <string>FT-ITC Project File</string>
        <key>CFBundleTypeRole</key>
        <string>Viewer</string>
        <key>LSHandlerRank</key>
        <string>Default</string>
        <key>LSItemContentTypes</key>
        <array>
            <string>public.ftitcproject</string>
        </array>
        <key>NSDocumentClass</key>
        <string></string>
    </dict>
</array>

补充信息 #

• 之前曾成功让Finder显示自定义测试图标，但无法复现操作步骤。
• 图标已在Assets中定义为「macOS generic icon」（截图：[项目中Assets文件夹截图]）

请问如何让关联文件显示自定义图标？成功修改后系统是否需要时间更新？

1. 检查图标配置细节 #

• 确保Assets中的图标名称与CFBundleTypeIconFile完全一致，注意macOS文件系统区分大小写。
• 确认图标资产包含所有必要尺寸（16x16、32x32、64x64、128x128、256x256、512x512、1024x1024），格式优先选择ICNS或PNG。
• 可先移除CFBundleTypeIconSystemGenerated键，或临时设置为1后改回0，强制系统重新识别自定义图标。

2. 清理系统缓存 #

系统可能缓存了旧配置，执行以下命令重置：

# 重置Launch Services数据库
/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister -kill -r -domain local -domain system -domain user

# 重启Finder
killall Finder

3. 验证UTI绑定一致性 #

确认UTExportedTypeDeclarations中的UTI定义，与LSItemContentTypes完全匹配；如果用UTI级别的图标配置，需确保UTI的UTTypeIconFile也指向正确图标名称。

4. 重新构建应用 #

• 执行Product > Clean Build Folder清理Xcode项目缓存。
• 重新安装应用，确保图标资源被正确打包进应用包。

系统更新时间 #

执行上述步骤后，Finder会立即刷新显示，但部分深层缓存可能需要1-2分钟完全生效；若仍不显示，可重启系统彻底清除缓存。

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