Roblox 多语言本地化：实现翻译表…

在 Roblox 游戏中为多语言支持、翻译表、自动翻译、地区内容或国家/地区检测做实现时使用。

适用场景

解决思路

1. 用 `player.LocaleId` 读取玩家为 Roblox 账号设置的语言环境，例如 `en-us`、`pt-br`、`ja-jp`。
2. 用 `LocalizationService.RobloxLocaleId` 读取 Roblox 核心/内部功能使用的语言环境。
3. 用 `LocalizationService.SystemLocaleId` 读取玩家操作系统的语言环境。
4. 用 `LocalizationService:GetCountryRegionForPlayerAsync(player)` 获取基于 IP 地理定位的国家代码，例如 `US`、`BR`、`JP`。
5. 创建/使用 `LocalizationTable` 存储翻译条目：key → 各 locale 的翻译。
6. 把父级 `LocalizationTable` 挂到 `LocalizationService` 下以启用自动翻译。
7. 在 GUI 对象上设置 `GuiBase2d.RootLocalizationTable`，为每个元素指定翻译表。
8. 在 Studio 中通过 Localization Tools 插件自动提取字符串到翻译表。
9. 启用自动翻译：在 GUI 及其祖先上设置 `AutoLocalize = true`，并确保翻译表中有匹配条目。
10. 正常设置 `TextLabel.Text`；引擎会根据玩家 locale 自动替换为翻译字符串。
11. 缺失翻译时回退到源文本。
12. 手动翻译：调用 `local translator = LocalizationService:GetTranslatorForPlayerAsync(player)`。
13. 用 `local translated = translator:Translate(game, "Welcome!")` 翻译普通文本。
14. 用 `local formatted = translator:FormatByKey("coins_count", {count})` 按 key 格式化带参数的翻译。
15. 国家/地区检测：调用 `local country = LocalizationService:GetCountryRegionForPlayerAsync(player)`。
16. 按国家分支处理内容/定价：`if country == "US" then -- USD pricing ... elseif country == "GB" then -- UK offer ... end`。
17. `GetCountryRegionForPlayerAsync` 是异步的；用 `pcall` 包裹，因为它可能失败。
18. `GetTranslatorForPlayerAsync` 是异步的；缓存返回的 translator。
19. 设置 `RootLocalizationTable` 来选择翻译表；沿祖先链保持 `AutoLocalize` 为 true。
20. 翻译条目结构：包含 `SourceText`、`SourceLocaleId`，然后是 `en-us`、`pt-br` 等列。
21. 在 Studio 中把翻译表导出/导入为 CSV 以批量编辑。
22. 在 Studio 的 locale simulator 中用不同 locale 测试。
23. 检查 `player.LocaleId`，确认目标 locale 是否被支持（并非所有 locale 都支持）。
24. 对非 GUI 文本不要依赖自动翻译；改用手动 `Translator:Translate`。
25. 注意 `GetCountryRegionForPlayerAsync` 使用 IP 地理定位，VPN 会导致结果错误。
26. 注意缺失条目会静默回退到源文本。

适用边界 · 注意事项

• 非 GUI 文本不要依赖自动翻译（AutoLocalize/AutoLocalization），应使用手动 `Translator:Translate`。
• 玩家可能使用 VPN/代理，IP 地理定位得到的国家/地区不可靠时，不要仅凭 `GetCountryRegionForPlayerAsync` 做关键决策。
• 目标 locale 未被 Roblox 支持，或 `player.LocaleId` 不在预期范围时，不要依赖自动翻译/本地化表覆盖。