在 macOS 上用 Xcode 管理图标资源的核心是通过 Asset Catalogs 实现结构化流程：创建图标集→按设备/场景填满尺寸→配置构建设置→代码安全引用；需覆盖全部必要尺寸，设好 Asset Catalog App Icon Set Name 和 Include all app icon assets，推荐使用 UIImage(named:) 或 SwiftGen 类型安全调用。

在 macos 上用 xcode 管理图标资源，核心是通过 asset catalogs（资产目录）统一组织、适配和调用图标。这不是简单拖图进项目，而是一套结构化流程：创建图标集 → 按设备/场景填满尺寸 → 正确配置构建设置 → 代码安全引用。

创建并填充 App Icon Set

打开项目中的 Assets.xcassets（默认存在），右键或点击底部“+”按钮，选择 New App Icon。Xcode 会自动生成一个名为 AppIcon.appiconset 的图标集，并按平台自动划分占位区。

• 必须覆盖全部必要尺寸：iPhone（60×60、120×120、180×180）、iPad（76×76、152×152、167×167）、App Store（1024×1024 PNG）、设置/通知中心（29×29、58×58、87×87）
• 直接将对应尺寸的 PNG 文件拖入对应占位区，Xcode 会自动识别并归类；不支持 JPG 或带透明通道异常的格式
• 多套图标（如节日版、灰度版）可新建多个 App Icon Set（如 FestivalIcon.appiconset），命名需清晰，避免空格或特殊字符

关键构建设置确认

仅把图标放进 Assets 不够，还需确保编译时正确打包：

• 选中项目 Target → Build Settings → 搜索 Include all app icon assets，设为 YES（Xcode 13+ 才有该选项）
• 搜索 Asset Catalog App Icon Set Name，值应为当前主图标集名称（如 AppIcon），注意大小写和拼写
• 若使用多环境（如 Debug/Release）或动态切换图标，建议在 User-Defined Settings 中添加变量（如 ICON_SET_NAME），并在 Build Settings 中用 $(ICON_SET_NAME) 引用

代码中安全引用图标

运行时加载图标推荐使用系统原生方式，避免硬编码字符串：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

• Swift 中直接调用：UIImage(systemName: "heart")（SF Symbols）或 UIImage(named: "icon_folder")（自定义图标）
• 为杜绝拼写错误、提升可维护性，可用 SwiftGen 等工具自动生成类型安全的访问枚举，例如：Asset.iconFolder.image
• 切勿手动写 UIImage(contentsOfFile: ...) 或依赖路径字符串——Asset Catalog 的优势就在于解耦路径与调用

调试与验证小技巧

图标没生效？别急着重拖，先检查这几处：

• Archive 后导出 IPA，改后缀为 .zip 解压，进入 xxx.app/Assets.car，用命令 xcrun --sdk iphoneos assetutil --info Assets.car 查看是否包含你的图标集及各尺寸
• 真机运行时，在 Xcode 调试栏选择 Debug → View Debugging → Capture View Hierarchy，选中 UIImageView 查看实际加载的 image 名称
• 图标显示模糊？确认 PNG 是无损导出、无多余画布、Alpha 通道干净；1024×1024 图标必须是纯正方形、无边框、无阴影