You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Shopify用SEO handle关联博客产品提示找不到product-card-list.liquid如何解决

报错产生原因

你收到的报错核心原因是当前使用的Shopify主题中不存在名为product-card-list.liquid的片段文件:

  • 教程提供的代码是基于教程作者使用的主题编写的,不同Shopify主题的产品卡片片段命名规则不同,大多不会统一使用product-card-list这个命名
  • 你直接复制了教程代码调用了不存在的片段,就会触发该报错,和你复制代码是否准确没有关系
  • 你后续提供的集合卡片代码和本次报错无关,无需修改
解决方法

按以下步骤操作即可正常实现产品与博客的关联:

  1. 查找主题自带的产品卡片片段
    进入Shopify后台的「在线商店 > 主题 > 编辑代码」页面,在左侧snippets文件夹下查找产品卡片对应的片段文件,常见命名为product-card、card-product、product-item等。
  2. 替换代码中的片段引用
    将你博客关联产品代码中的{% include 'product-card-list' %}替换为你找到的实际片段名,同时注意补充必要参数(大多主题调用产品卡片需要明确传递product参数),示例如下:
# 假设你找到的片段名为product-card
{% include 'product-card', product: product %}
  1. 无对应片段的替代方案
    如果找不到主题自带的产品卡片片段,可以直接用简易产品卡片代码替换原有的引用语句,示例如下:
<div class="product_item">
  <a href="{{ product.url }}" class="product_item_link">
    <img src="{{ product.featured_image | img_url: '300x' }}" alt="{{ product.title }}">
    <h4 class="product_title">{{ product.title }}</h4>
    <p class="product_price">{{ product.price | money }}</p>
  </a>
</div>
  1. 测试验证
    保存修改后的代码,给目标博客文章添加和产品handle完全一致的标签,访问前台博客页面确认无报错、产品正常展示即可。

内容的提问来源于stack exchange,提问作者Jo11

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.07 13:12:02