swiftui-expert-skill - text-patterns

SwiftUI 文本模式参考

更广泛的本地化指导——String Catalogs、包的 #bundle、LocalizedStringResource、locale 感知格式化、RTL 布局和翻译人员注释——请参阅 references/localization.md。本文件只涵盖单个 Text 的 verbatim 与本地化决策。

目录

• Text 初始化：Verbatim 与本地化

Text 初始化：Verbatim 与本地化

默认：始终使用 Text("…")。 仅当字符串字面量必须不被本地化时才显式使用 Text(verbatim:)。

// 本地化字面量 – "Save" 用作本地化键并在 Localizable.strings 中查找（仅当项目中存在时）
Text("Save")

// 字符串变量 – 自动绕过本地化；无需 verbatim
let filename: String = model.exportFilename
Text(filename)

// 非本地化字面量 – 仅当字面量必须不被本地化时使用 verbatim
Text(verbatim: "pencil")

决策流程

输入是 String 变量还是动态值？
└─ 是 → Text(variable) // 自动绕过本地化

字符串字面量是否用于本地化？
├─ 是 → Text("…") // 默认；键在 Localizable.strings 中查找
└─ 否 → Text(verbatim: "…") // 仅当显式非本地化时