服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 所有包含 UI 扩展的应用、所有 API 版本均不再受多语言文件 256 KB 合计上限约束。
- 每个文件 30 KB 的限制仍有效;文件总量可超过旧上限,但单个超限文件仍不符合该项限制。
- 将曾删减的语言文件放回扩展 locales 目录,部署新应用版本,并在开发商店预览新增语言。
- 此次调整针对 UI 扩展字符串,不增加店面 Translate & Adapt 语言名额,也不替代其他部署要求。
多语言文件合计 256 KB 上限已取消
Shopify 于 2026 年 10 月 30 日取消 UI 扩展多语言文件合计 256 KB 的限制。此调整适用于所有包含 UI 扩展的应用及所有 API 版本。
已有扩展版本仍可继续使用。如果文件原本低于 256 KB,无需采取行动;此次变化不要求重写或重新部署。
单个文件仍受 30 KB 限制
取消的是合计上限。每个多语言文件 30 KB 的限制仍然存在,其他部署约束也不会因此消失。
假设 10 个各 27 KB 的文件合计 270 KB。每个文件都低于 30 KB;过去总量超过 256 KB 会挡住部署,现在不会仅因总量而受阻。单个 31 KB 文件仍超过限制。
按原有约定恢复语言文件
如果你曾删减译文或移除语言,可将所需文件放回扩展的 locales 目录,例如 de.json 或 pt-BR.json。文件格式、命名和回退行为保持不变。
这些文件用于 UI 扩展字符串,与 Translate & Adapt 的店面翻译不同;公告没有扩大自动翻译服务或语言名额。
默认语言也应保留。Shopify 的 Checkout 指南使用 en.default.json 作为示例;没有其他合适语言匹配时会使用默认语言。若要换默认语言,按 [locale].default.json 命名对应文件,而不是把所有语言都改成默认文件。
新增语言不仅要翻译固定文字,还要检查数字、货币和单复数表达。Checkout 指南分别演示数字与货币格式化,以及 zero、one、other 等复数键;取消总量限制不会替你完成这些本地化内容。
部署并预览
运行 shopify app deploy 发布新应用版本,再到开发商店预览扩展,并将商店或客户语言设为新增语言,确认扩展字符串正常显示。
若译文未显示,先核对当前预览语言和文件命名。Checkout 指南还要求在开发商店添加并发布第二种语言,并在主要市场启用该语言。
预览时选一个实际恢复的语言,核对原先被删减的字符串,再切回默认语言比较。把语言文件恢复、应用版本部署完成和页面实际显示译文分开确认,便于发现文件已加入但预览语言未切换的情况。
扩展资格及其他校验不变
公告未宣布价格、地区范围或扩展资格变化。Shopify 指南仍说明,显示在信息、配送和付款步骤中的 Checkout UI 扩展仅适用于 Shopify Plus 商店。
资料来源
常见问题
没有匹配的语言时,会使用哪种语言?
Checkout 本地化指南说明,会使用扩展配置的默认语言。默认文件采用 [locale].default.json 命名,例如 en.default.json;此次更新没有改变回退行为。
区域语言文件可以继续用 pt-BR.json 这样的名称吗?
可以。公告明确把 pt-BR.json 和 de.json 作为可恢复的文件示例,并说明命名约定不变。文件仍放在扩展的 locales 目录。
Shopify 会替我生成新语言的译文吗?
本次变更只取消文件合计大小限制,公告没有提供新的自动翻译能力。需要恢复或补充的扩展字符串,仍按原有本地化流程维护。