Shopify中如何高效拉取单品及变体的Metafields？

安全阿岳

2026-8-12

Shopify商品/变体Metafields高效获取方案

1. 统一获取商品/变体的Metafields集合

先通过判断商品是否存在变体，统一指定要读取的Metafields来源，无需重复区分单品或变体：

{%- assign target_metafields = product.metafields.global -%}
{%- if product.variants.size > 0 and product.selected_or_first_available_variant -%}
  {%- assign target_metafields = product.selected_or_first_available_variant.metafields.global -%}
{%- endif -%}

逻辑说明：如果商品有多变体且存在选中/默认变体，则使用该变体的global命名空间Metafields；否则直接使用商品自身的Metafields。

2. 替代逐个判断的高效遍历写法

不用为每个Metafield单独写if判断，可通过定义字段与标题的映射，批量处理：

{%- assign dimension_field_map = {
  "seat_width_cm": "Seat Width (cm)",
  "seat_depth_cm": "Seat Depth (cm)",
  "length_cm": "Length (cm)"
} -%}

{%- for field_key in dimension_field_map -%}
  {%- assign field_title = dimension_field_map[field_key] -%}
  {%- assign field_value = target_metafields[field_key].value -%}
  {%- if field_value != blank -%}
    <tr>
      <td>{{ field_title }}</td>
      <td>{{ field_value }}</td>
    </tr>
  {%- endif -%}
{%- endfor -%}

3. 动态调用Metafields的正确写法

你尝试的动态注入写法需要调整：Liquid中无法通过.访问变量键名的Metafield，必须使用方括号[]来动态获取。修改后的代码如下：

{%- assign main_dimensions = "width_cm, height_cm, depth_cm, length_cm" | split: ',' -%}
{%- assign main_dimensions_title = "Width (cm), Height (cm), Depth (cm), Length(cm)" | split: ',' -%}

{%- for index in (0..main_dimensions.size | minus: 1) -%}
  {%- assign field_key = main_dimensions[index] | strip -%}
  {%- assign field_title = main_dimensions_title[index] | strip -%}
  {%- assign field_value = target_metafields[field_key].value -%}
  {%- if field_value != blank -%}
    {{ field_title }} - {{ field_value }}<br>
  {%- endif -%}
{%- endfor -%}