iOS 11 Swift 4本地化异常求助：繁体中文显示失效

我之前做iOS本地化的时候也踩过几乎一模一样的坑——本地模拟器和自己设备测试全正常，上架后部分繁体用户就反馈本地化失效，后来折腾了好久才找到问题根源，给你整理几个关键点，你可以逐一验证：

1. 别再用NSLocale了，换Locale试试！ #

Swift里推荐用原生的Locale类而非NSLocale，旧的NSLocale.current.languageCode在部分系统版本或特殊区域设置下，返回值可能不符合预期。试试替换成更稳妥的写法：

// 方法1：用Locale的languageCode
let languageCode = Locale.current.languageCode
// 方法2：优先取用户首选语言数组的第一个元素（更贴合用户设置优先级）
let preferredLang = Locale.current.preferredLanguages.first

我当时就是换成preferredLanguages.first后，解决了部分用户语言识别错误的问题——有些用户的系统语言优先级里，繁体可能不是第一顺位，但preferredLanguages会严格按照用户设置的顺序返回。

2. 检查本地化文件的命名规范 #

你本地测试返回"zh"能正常显示，大概率是只做了zh.lproj文件夹，但繁体中文在iOS里的标准本地化代码是zh-Hant（通用繁体，覆盖台湾、香港等所有繁体地区），或者分区域的zh-Hant-TW、zh-Hant-HK。如果你的App只打包了zh.lproj，而部分繁体用户的系统语言代码是zh-Hant，App会找不到对应资源，直接 fallback到默认语言。

解决方法：

• 把繁体本地化文件迁移到zh-Hant.lproj文件夹（通用所有繁体场景）
• 若需要针对不同繁体区域做差异化适配，再单独创建zh-Hant-TW、zh-Hant-HK等区域文件夹

3. 确认打包时本地化资源没被遗漏 #

Xcode打包时偶尔会出现本地化资源被意外排除的情况，尤其是用了App Thinning或手动修改过Build Phases的话：

• 打开Xcode的Build Phases -> Copy Bundle Resources，检查是否包含了所有需要的.lproj文件夹
• 导出IPA后，右键「显示包内容」，查看Contents/Resources目录下是否有zh-Hant.lproj（或对应的繁体文件夹）

4. 测试极端场景的语言设置 #

有些用户的设置可能和你的测试环境不一样，比如：

• 用户系统语言是英文，但区域设置为台湾/香港，这时候languageCode可能返回en，但用户期望显示繁体
• 用户设置了多种语言，繁体在第二顺位

这种情况下，你需要写个更灵活的判断逻辑，优先识别繁体相关的语言代码：

func getCurrentLocalization() -> String {
    let preferredLangs = Locale.current.preferredLanguages
    for lang in preferredLangs {
        if lang.starts(with: "zh-Hant") {
            return "zh-Hant"
        } else if lang.starts(with: "zh") {
            return "zh-Hans"
        }
    }
    return "en" // 默认 fallback 语言
}

5. 验证App支持的本地化列表 #

在App启动时打印当前Bundle支持的本地化，确认繁体在列表里：

print("Supported localizations: \(Bundle.main.localizations)")

如果输出里没有zh-Hant，那肯定是打包时没包含对应的资源，需要重新检查Xcode配置。

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