iOS如何检测.strings本地化字符串存在性并实现默认值回退

需求说明 #

需要根据运行时变量匹配对应本地化字符串，规则为：优先匹配带特殊后缀的变体字符串，若变体不存在则自动回退到对应键的默认字符串。

当前实现 #

本地化配置 #

localizable.strings文件内容如下：

// localizable.strings
"com.myapp.text1"         = "The default text 1";
"com.myapp.text1#SPECIAL" = "The special text";
"com.myapp.text2"         = "The default text 2";

初始实现代码 #

let key1     = "com.myapp.text1"
let key2     = "com.myapp.text2"
let modifier = "#SPECIAL"

print( NSLocalizedString(key1 + modifier
                        , value:  NSLocalizedString(key1, comment: "")
                        , comment: "") )
// 常规场景输出: "The special text"
print( NSLocalizedString(key2 + modifier
                        , value: NSLocalizedString(key2, comment: "") // 传入默认回退值
                        , comment: "") )
// 常规场景输出: "The default text 2"

常规场景下该实现符合预期：存在#SPECIAL后缀的特殊键时返回对应特殊文案，不存在时返回默认键对应的默认文案。

存在的异常 #

当系统NSShowNonLocalizedStrings配置项设为true时（可通过启动参数、终端命令、代码手动设置），该方案会失效：系统检索不到对应本地化字符串时，会直接返回键名的大写形式，完全忽略传入的默认值，同时控制台打印本地化缺失错误日志，证明该实现不符合NSLocalizedString的设计使用方式。
异常复现代码：

UserDefaults.standard.set(true, forKey: "NSShowNonLocalizedStrings") // 支持多种设置方式
print( NSLocalizedString(key2 + modifier
                        , value: NSLocalizedString(key2, comment: "")
                        , comment: "") )
// 控制台输出错误: ERROR: com.myapp.text2#SPECIAL not found [...]
// 实际返回值: "COM.MYAPP.TEXT2#SPECIAL"

目前已知的两种临时解决方案都存在明显缺陷：

• 判断返回值是否为键名大写形式做兼容，属于掩盖问题的hack方案，鲁棒性极差
• 自行实现Bundle层面的键存在性检测，需要重写.strings文件解析、缓存整套逻辑，实现成本高，不符合平台原生设计思路

待解答疑问 #

1. 是否存在未被广泛了解的系统原生方法，可以直接实现该需求？
2. 这种「特殊变体+默认回退」的本地化实现思路，本身是否不符合苹果平台的设计规范？

原生能力说明 #

系统原生框架完全支持该需求，不需要自行实现.strings文件解析、缓存逻辑。之前的实现失效，本质是对NSLocalizedString的参数语义和查找规则理解有偏差。
另外这种「变体优先、默认兜底」的本地化思路完全符合苹果平台的设计规范，问题出在实现方式，而非需求本身。 #

正确实现方式 #

苹果Bundle自带的localizedString(forKey:value:table:)接口本身内置了查找失败的回退逻辑，之前触发NSShowNonLocalizedStrings异常的核心原因是：嵌套调用NSLocalizedString将另一个本地化查找结果作为value参数传入，而该参数的设计初衷是接收硬编码的开发语言兜底值，系统识别到传入的value不是硬编码默认值时，会把变体键查找失败判定为「本地化缺失」，从而触发大写返回、打印错误日志的逻辑。
不需要hack返回值，也不需要自行解析文件，直接基于原生接口做一层键命中判断即可，完全复用系统的缓存和查找逻辑：

extension Bundle {
    func getLocalizedText(baseKey: String, variantSuffix: String? = nil) -> String {
        // 优先查找变体键
        if let suffix = variantSuffix {
            let variantKey = baseKey + suffix
            // 查找变体时传入空字符串作为兜底值，键不存在时方法会直接返回传入的空兜底值
            let variantText = self.localizedString(forKey: variantKey, value: "", table: nil)
            // 返回值非空说明命中变体文案，直接返回
            if !variantText.isEmpty {
                return variantText
            }
        }
        // 变体不存在，返回默认键对应的文案
        return self.localizedString(forKey: baseKey, value: baseKey, table: nil)
    }
}

该实现不会触发NSShowNonLocalizedStrings的错误提示：变体键不存在时，方法会直接拿到传入的空兜底值，不会触发系统的缺失本地化判定，自然不会打印日志、返回大写键名。 #

规范实践建议 #

用后缀区分同逻辑的文案变体本身是苹果生态内的通用做法，系统自带的本地化能力本身就支持多维度文案变体（比如不同设备类型、同语言不同地区、无障碍简化文案等），不存在不符合设计规范的问题。
如果变体规则是固定的（比如面向特定用户群、特定功能开关的专属文案），更推荐的实践是把变体文案单独拆分为独立的.strings文件，比如将特殊变体放在Localizable-Special.strings中，查找时先查Special表，命中失败再回退到默认的Localizable表，这种方式更方便翻译时核对键值，不容易出现漏翻、错翻问题，也完全符合苹果的本地化文件管理规范。 #

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