layout 漏了 content_for_layout 后页面只剩页头
现象#
换过 layout 后所有页面只剩页头和页脚,商品、集合、文章正文全部不见,编辑器预览区一片空白但控制台没有报错。
原因#
layout/theme.liquid必须输出{{ content_for_layout }},模板内容才会被注入- 重写 layout 时把该输出放进条件分支,部分模板走不到
- 把 section group 的
{% sections 'header-group' %}误当成内容占位 - 主题有多套 layout,只有一套带该输出,而模板的
layout字段指向了另一套
处理步骤#
- 打开
layout/theme.liquid,确认{{ content_for_layout }}位于 body 内的主内容区 - 把它移出任何
{% if %}分支,保证所有页面都能输出 - 检查模板 JSON 是否指定了
layout字段,对应的 layout 文件同样要补占位 - 页头页脚 section group 的输出要保留,和内容占位互不替代
- 推送后在编辑器依次打开首页、商品、集合页,确认正文恢复
验收标准#
各页面正文正常渲染,查看源码能看到模板中 section 的 shopify-section- 容器。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。