Shopify子文件夹站点如何动态配置多地区hreflang标签

触发Liquid报错的核心原因是Liquid语法不支持在输出标签的过滤器参数内嵌套双大括号，单引号包裹的{{ localization.country.iso_code }}会被识别为普通字符串，不会解析为变量，嵌套大括号的写法本身就违反Liquid解析规则。
最初写的硬替换us为au的写法只能适配单一场景，只要当前访问路径的地区前缀不是us就会生成错误路径，完全无法覆盖多市场需求。 #

可直接部署的动态生成代码 #

Shopify原生localization对象已自带后台所有已启用市场的配置数据，不需要硬编码单个国家的替换规则，直接遍历所有已配置市场批量生成hreflang标签即可，完美适配/en-[国家ISO码]的子文件夹结构：

{% comment %} 提取不带地区前缀的页面核心路径，避免重复拼接前缀导致路径错误 {% endcomment %}
{% assign core_path = canonical_url | remove: shop.url %}
{% assign path_segments = core_path | split: '/' %}
{% if path_segments[1] contains 'en-' %}
  {% assign core_path = '/' | append: path_segments | slice: 2, 200 | join: '/' %}
{% endif %}

{% comment %} 遍历所有已启用市场，批量生成对应hreflang标签 {% endcomment %}
{% for market in localization.available_markets %}
  {% assign country_iso = market.country.iso_code | downcase %}
  {% assign hreflang_val = 'en-' | append: country_iso %}
  {% assign page_url = shop.url | append: '/' | append: hreflang_val | append: core_path %}
  <link rel="alternate" hreflang="{{ hreflang_val }}" href="{{ page_url }}" />
{% endfor %}

{% comment %} x-default默认指向，可根据自身默认市场修改对应地区码 {% endcomment %}
<link rel="alternate" hreflang="x-default" href="{{ shop.url }}/en-us{{ core_path }}" />

方案特性 #

• 零手动维护：只要在Shopify后台「设置-市场」中启用对应国家的子文件夹站点，代码会自动识别并生成对应hreflang标签，后续新增市场不需要修改代码
• 路径准确性高：自动剥离当前URL里已有的地区前缀再重新拼接，不会出现重复拼接/en-xx导致的404问题
• 语法兼容：所有变量单独赋值后再做拼接处理，完全符合Liquid语法规则，不会触发解析报错

单场景临时写法修正 #

如果只需要临时做单地区替换，不要在过滤器参数里嵌套大括号，直接传入变量即可避免报错：

<!-- 正确的replace传变量写法，无语法错误 -->
<link rel="alternate" hreflang="en-au" href="{{ canonical_url | replace: localization.country.iso_code, 'au' }}"  />

该写法仅适合临时测试使用，扩展性极差，正式多市场环境不推荐使用。

内容的提问来源于stack exchange，提问作者johnhgaspay