SwiftUI自定义视图如何实现LocalizedStringKey与StringProtocol双初始化

问题核心 #

你当前的问题在于提前将标题转换为String类型，但LocalizedStringKey的本地化解析依赖SwiftUI环境中的本地化配置，在初始化阶段无法完成正确的本地化转换。苹果的实现思路是将本地化逻辑交给专门的视图组件（如Text）处理，而非在自定义视图内部提前解析字符串。

解决方案1：直接存储Text实例（兼容所有SwiftUI版本） #

这种方式完全复用Text的本地化能力，不需要自己处理两种类型的转换，和系统Button的实现逻辑一致：

import SwiftUI

struct CustomView<Content: View>: View {
    private let titleText: Text
    @ViewBuilder let content: Content

    init(_ titleKey: LocalizedStringKey, @ViewBuilder content: () -> Content) {
        self.titleText = Text(titleKey)
        self.content = content()
    }
    
    init<S>(_ title: S, @ViewBuilder content: () -> Content) where S : StringProtocol {
        self.titleText = Text(title)
        self.content = content()
    }

    var body: some View {
        ZStack {
            Color.green
            titleText
        }
    }
}

解决方案2：使用LocalizedStringResource（iOS 15+/macOS 12+） #

如果你的项目支持iOS 15及以上，可以用LocalizedStringResource统一封装两种标题类型，它能自动处理本地化逻辑：

import SwiftUI

struct CustomView<Content: View>: View {
    private let title: LocalizedStringResource
    @ViewBuilder let content: Content

    init(_ titleKey: LocalizedStringKey, @ViewBuilder content: () -> Content) {
        self.title = LocalizedStringResource(titleKey)
        self.content = content()
    }
    
    init<S>(_ title: S, @ViewBuilder content: () -> Content) where S : StringProtocol {
        self.title = LocalizedStringResource(stringLiteral: String(title))
        self.content = content()
    }

    var body: some View {
        ZStack {
            Color.green
            Text(title)
        }
    }
}

为什么这是苹果的实现思路 #

系统组件（如Button）并没有在内部存储String类型的标题，而是依赖Text等组件的本地化能力：

• 当传入字符串字面量时，Swift自动推断为LocalizedStringKey，由Text负责从本地化文件中加载对应内容
• 当传入字符串变量时，直接使用原始字符串，跳过本地化流程
• 这种设计避免了重复实现本地化逻辑，同时保证了环境依赖的本地化配置能正确生效

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