You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

本地化key含特殊字符.导致应用崩溃的规则及参考文档咨询

本地化key格式限制相关解答

1. 本地化key的格式限制要求

  • 不同平台的本地化key格式规则存在明确差异:
    • 安卓平台的strings.xml资源key要求符合Java标识符命名规范,明确禁止包含.、空格、特殊符号等字符,不符合规则的key会直接触发编译报错;如果是通过自定义逻辑动态加载本地化文件使用带.的key,也可能触发资源解析逻辑的运行时崩溃。
    • 苹果平台(iOS/macOS等)的.strings文件没有明确禁止key包含.,但.会被NSLocalizedString默认解析逻辑识别为KVC键路径分隔符,系统会尝试按.拆分字符串嵌套查找本地化值,找不到对应层级结构就会触发未识别键路径的崩溃,这是你遇到问题的核心原因。
  • 通用的本地化key推荐规则是使用下划线_替代.作为分隔符,你使用的示例"x_articles.one" = "%s product"可以修改为"x_articles_one" = "%s product"即可规避崩溃问题。
  • 除.之外,空格、换行等不可见字符,以及@、#、:等在部分本地化解析工具中被标记为特殊功能的字符,都不建议出现在key中,避免出现解析异常。

2. 相关参考资料说明

对应格式限制规则可以在对应平台官方开发者文档的本地化开发章节、字符串资源解析规则章节查阅,也可以查看对应平台开源的本地化解析源码,确认key的解析处理逻辑。


内容的提问来源于stack exchange,提问作者Guigzer

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.27 23:45:03