求助：Xcode无法正确处理主Bundle外定义的Named Colors问题

我之前也遇到过完全一样的困扰！咱们做共享UI组件Framework时，Storyboard编辑器和预览能正常识别跨模块的Named Colors，但一到模拟器/真机运行，Framework里的颜色就找不到，只能用回退值——核心原因就是Xcode运行时默认只会从主Bundle加载资源，不会自动关联Framework的Bundle，哪怕设计阶段能识别工作区内的其他模块资源。

下面是几个经过验证的解决方案，你可以根据项目场景选择：

方案1：代码层面手动指定Framework Bundle加载颜色 #

如果不想改动Storyboard的布局，这个方法最直接：

• 先在你的Framework里封装一个颜色获取工具方法，明确指定从Framework自身的Bundle加载：

import UIKit

extension UIColor {
    static func frameworkColor(named name: String) -> UIColor? {
        // 用Framework里任意一个类来获取对应的Bundle
        let frameworkBundle = Bundle(for: FrameworkComponent.self)
        return UIColor(named: name, in: frameworkBundle, compatibleWith: nil)
    }
}

• 然后在使用该Framework的App的ViewController里，替换Storyboard中控件的颜色：

override func viewDidLoad() {
    super.viewDidLoad()
    // 替换Storyboard里的控件颜色为Framework的Named Color
    titleLabel.textColor = .frameworkColor(named: "FrameworkPrimaryText")
    backgroundView.backgroundColor = .frameworkColor(named: "FrameworkBackground")
}

方案2：修改Storyboard，显式指定颜色所属的Bundle #

这个方法能让Storyboard直接加载Framework的颜色，不需要额外代码修改：

1. 打开使用了Framework颜色的Storyboard/XIB文件，选中目标控件
2. 在右侧Attributes Inspector里找到颜色设置项，点击颜色选择器右上角的齿轮图标（Settings）
3. 选择Customize选项，在弹出的配置窗口里找到Bundle下拉菜单，选择你的Framework对应的Bundle（比如ResourcesModule.bundle）
4. 重新选择对应的Named Color，保存后编译运行即可

方案3：确保Framework的Asset Catalog配置正确 #

有时候问题出在Framework的资源配置上，你可以检查以下几点：

• 选中Framework的Assets.xcassets文件，在右侧File Inspector里确认Target Membership只勾选了你的Framework目标，避免资源被打包到主Bundle
• 打开Framework的Build Settings，搜索ASSETCATALOG_COMPILER_GENERATE_SWIFT_ASSET_SYMBOLS，确保设置为YES——这会自动生成颜色的静态属性，你可以直接用UIColor.frameworkPrimaryText这种方式调用，不需要手动写Bundle加载逻辑
• 确认Framework的Bundle Identifier配置唯一，避免和主App或其他Framework的Bundle冲突

验证方式 #

修改完成后，可以通过以下方式确认问题解决：

• 运行App切换明暗模式，检查控件颜色是否正确响应
• 在代码里打印Framework的Bundle路径，确认资源被正确加载：

print(Bundle(for: FrameworkComponent.self).bundlePath)

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