在全球化业务场景下，多语言适配已成为小程序提升境外用户体验、拓展境外市场和服务境外人士来华的关键能力。为帮助开发者高效触达不同语言背景的用户，平台鼓励开发者进行多语言适配，并提供小程序翻译能力，为Wechat/微信用户提供更友好的小程序使用体验。

一、开发者自行适配

平台鼓励开发者自行适配多语言版本，为Wechat/微信用户提供更友好的小程序使用体验。

开发者可通过以下两种接口感知用户客户端语言/目标翻译语言，并自行适配：

1. 开发者可通过wx.getAppBaseInfo接口，根据返回的language字段，获取用户客户端语言版本，在小程序内适配用户语言，并内置多语言切换功能。Object wx.getAppBaseInfo() | 微信开放文档
2. 开发者可通过wx.onOnUserTriggerTranslation监听用户触发小程序的翻译功能事件，动态将页面的核心内容进行多语言适配。wx.onOnUserTriggerTranslation(function listener) | 微信开放文档

二、小程序翻译（官方能力）

若开发者未自适配多语言版本，平台提供的小程序翻译支持18种语言，为用户提供翻译功能。

1、小程序翻译功能说明

• 设置翻译语言：目标翻译语言默认为微信客户端使用的语言。若需要调整翻译语言，用户可进入“我” - “设置” - “通用” - “翻译”从语言列表中选择翻译语言。
• 打开小程序翻译：可使用两种方式（1）进入小程序，若右上角显示“翻译”气泡，点击“翻译”按钮；（2）点击小程序右上角的 “…” 按钮，在弹窗点击“翻译”按钮；
• 取消小程序翻译：点击小程序右上角的 “…” 按钮，在弹窗点击“取消翻译”按钮；
• 切换小程序翻译语言：当小程序翻译打开时，可点击小程序右上角的 “…” 按钮，在弹窗点击“更换语言”按钮，切换翻译语言；
• 小程序翻译支持18种语言：简体中文、繁体中文（台湾）、繁体中文（香港）、英语、印度尼西亚语、马来语、西班牙语、韩语、意大利语、日语、葡萄牙语、俄语、泰语、越南语、阿拉伯语、土耳其语、德语、法语

2、小程序翻译能力适配

平台提供的小程序翻译能力开发者无法隐藏或禁用，但可通过以下方式优化用户体验：

（1）页面适配：考虑多语言的文本长度、词汇分界等差异，开发者在小程序页面设计上，需要关注并适配翻译后文本内容过长而“溢出”的异常情况。

（2）文本规范：小程序翻译功能仅适用于文本翻译，无法识别图片中的文字。开发者在小程序页面设计上，避免使用图片代替文字，尽可能确保文本表达清晰、直观。

（部分商户的页面适配和文本规范）

（3）翻译动态适配：开发者可通过wx.onOnUserTriggerTranslation监听用户触发小程序的翻译功能事件，并动态将页面核心内容（品牌词、产品词等）调整为目标翻译语言，平台识别到该内容已经为目标翻译语言后，将不会二次翻译。示例：

a. 监听到用户开启翻译功能，目标语言为阿拉伯语

b. 开发者将页面内商品名称修改成阿拉伯语的专有词汇，其他内容不做翻译

c. 平台识别到商品名称已经是阿拉伯语，不做二次翻译，只翻译其他内容

wx.onOnUserTriggerTranslation(function listener) | 微信开放文档

（4）词库维护（内测）：若开发者认为小程序的翻译结果与预期不符，平台支持开发者维护自身小程序的翻译词库（小程序名称、品牌词、产品词、专业词汇等），在内测阶段，开发者可通过邮件向平台提交翻译词库文件，平台审核通过后，对应小程序的翻译结果将根据词库进行更新。

邮件标题：【内测—翻译词库维护】APPID+小程序主体信息

发送邮件：miniprogram_global@tencent.com

邮件内容：提供翻译词库文件，翻译词库文件参考模版为 翻译词库维护(模版).xlsx

请注意：内测期间仅支持通过邮件发送，小程序后台词库维护功能开发中，敬请期待

• 翻译词库Excel文件首列为小程序主语言，若小程序主语言为中文，则将中文放在A列；若小程序主语言为英文，则将英文放在A列，以此类推；
• 若商户仅维护部分语言版本，在其余语言版本的翻译内容为空即可；

问题反馈与交流通道：若您有任何疑问，欢迎在交流专区发帖咨询，或邮件联系我们

• 小程序境外开放交流专区小程序境外交流专区 | 微信开放社区
• 小程序境外业务邮箱 miniprogram_global@tencent.com