标题备选

1. Shopify 开发实战：Shopify 多语言配置 一篇讲清楚
2. 手把手梳理 Shopify：Shopify 多语言配置 的关键用法和避坑点
3. 做 Shopify 项目别只会改主题，这篇带你搞懂 Shopify 多语言配置

摘要

这篇文章适合 Shopify 主题和应用开发者，围绕「Shopify 多语言配置」梳理核心概念、配置路径和实战注意点，方便项目中快速对照。

正文

哈喽大家好👋 我是程序🦍kk。把复杂知识掰成大白话讲明白，是我一直以来的小追求✨；打好基础才能稳步进阶，是我始终秉持的学习理念～

📢 我搭建了5000人程序猿专属学习交流群 群内会同步前端开发/全栈开发/Web3开发/远程工作等干货资源 关注我并回复 加群 ，就能加入交流圈啦🚀

前言

Shopify 项目最容易卡住的地方，往往不是“会不会写代码”，而是主题、应用和后台配置之间的关系没理顺。

很多同学做 Shopify 开发时，会同时碰到 Liquid、主题目录、Checkout、Metafields、应用后台、性能优化这些概念。单独看不难，放到真实项目里就容易散。

这篇围绕「Shopify 多语言配置」把原始笔记整理成更适合阅读和复用的版本，适合做主题开发、应用开发或者接手 Shopify 项目时快速对照。

Shopify 实战整理

下面进入 Shopify 相关内容整理。建议大家边看边对照自己的店铺、主题代码和应用后台，很多问题只有放到真实配置里才容易看清楚。

如果你正在做 Shopify 项目，可以重点留意主题代码、后台配置、应用能力和官方限制之间的边界，很多线上问题都出在这些交界处。

Shopify 多语言 JSON 文件的工作原理：

文件结构
项目里通常有几个 locale 文件：

locales/en.default.json — 英文（默认语言）
locales/zh-CN.json — 中文（如果有的话）
其他语言...
如何使用
在 Liquid 模板里通过 | t filter 调用：

{{ 'products.product.from_lowest_price_html' | t: lowest_price: money_price }}
这里的 key products.product.from_lowest_price_html 对应 JSON 文件里的嵌套路径：

{
  "products": {
    "product": {
      "from_lowest_price_html": "from {{ lowest_price }}"
    }
  }
}
| t 就是 translate 的缩写，Shopify 会根据当前店铺语言去对应的 JSON 文件里取值。

带变量的翻译
翻译值里可以嵌入变量（用 {{ }} 包裹），调用时用命名参数传入：

{{ 'general.pagination.next' | t }}
{{- 结果: "Next" -}}
{{ 'products.product.from_lowest_price_html' | t: lowest_price: "$1,008.00" }}
{{- 结果: "from $1,008.00" -}}
带 HTML 的翻译
key 名里带 _html 后缀的（如 from_lowest_price_html），翻译值可以包含 HTML 标签，Shopify 会直接输出原始 HTML 而不转义：

"from_lowest_price_html": "from <strong>{{ lowest_price }}</strong>"
多语言切换
当店铺切换语言时，| t 自动去对应语言的 JSON 文件取值，找不到 key 时降级到 en.default.json。这就是为什么改硬编码文本要改 locale 文件而不是直接写死在 Liquid 里。

写在最后

好啦，今天的分享就到这里！

💬 互动时间：

你现在做 Shopify 更常遇到的是主题开发、Checkout 定制、应用接入，还是性能优化？如果你在「Shopify 多语言配置」上踩过坑，也可以把场景留言出来。

最后，感谢你看到这里👏

如果喜欢这篇内容，不妨顺手给小编安排一波👇 点赞👍｜转发📲｜推荐❤️｜评论📣

要是想第一时间蹲到新内容推送，记得给我点个星标⭐️

更多干货内容正在持续填坑中，咱们下期见👋

标签建议

Shopify、主题开发、独立站