如何为macOS自定义文档类型设置全局生效的自定义文件图标？

一、让自定义图标全局生效（解决图标视图显示JSON内容的问题） #

• 检查Info.plist的UTI配置完整性
  确保CFBundleDocumentTypes里的LSItemContentTypes优先绑定你的自定义UTI（com.example.xyz），不要把public.json放在首位。同时确认UTExportedTypeDeclarations的配置完整：

  <key>UTExportedTypeDeclarations</key>
  <array>
      <dict>
          <key>UTTypeIdentifier</key>
          <string>com.example.xyz</string>
          <key>UTTypeDescription</key>
          <string>Example XYZ Document</string>
          <key>UTTypeIconFile</key>
          <string>xyz.icns</string>
          <key>UTTypeConformsTo</key>
          <array>
              <string>public.json</string>
          </array>
          <key>UTTypeTagSpecification</key>
          <dict>
              <key>public.filename-extension</key>
              <array>
                  <string>xyz</string>
              </array>
          </dict>
      </dict>
  </array>
  

  还要确认xyz.icns已加入项目资源，且在Build Phases的Copy Bundle Resources列表中。

• 重置Finder图标缓存
  打开终端执行以下命令，强制刷新系统图标缓存：

  killall Finder
  rm -rf ~/Library/Caches/com.apple.iconservices.store
  killall Dock
  

  完成后重启Mac，再检查图标显示情况。

• 锁定文件关联优先级
  右键任意.xyz文件，选择「显示简介」，在「打开方式」中选中你的应用，点击「全部更改」，让系统将你的应用设为该类型文件的默认打开程序。

二、为自定义文档添加类似PYTHON的标识 #

• 编辑.icns文件添加文字标识
  macOS的.icns包含多尺寸图标图层，用预览或专业图标工具（如IconKit）打开xyz.icns，编辑1024x1024的大尺寸图层，添加“XYZ”文字标识（参考.py文件的样式），保存时确保所有必要尺寸（16x16到1024x1024）都保留。

• 完善UTI描述增强识别
  在UTExportedTypeDeclarations里设置清晰的UTTypeDescription（比如“XYZ JSON文档”），Finder的列表视图和文件简介面板会显示该描述，帮助用户快速识别。

• 可选：开发Quick Look插件（进阶）
  如果需要更显眼的预览标识，可以开发轻量的Quick Look插件，让.xyz文件在图标视图的预览区域显示自定义标识，不过这需要额外的开发工作。

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