用固定主题版本核对一个模块
官方主题核对路线:先读通用模块契约,再用覆盖矩阵定位实现,对照 Dawn 与 Horizon 固定版本的源码解读,写出主题与契约之间的差距记录。
开始前
- 已读过官方主题研究方法,知道结论限于固定提交。
- 理解 Section、Block 与 JavaScript 自定义元素的基本关系。
本路线练习一件事:不凭印象判断主题「有没有」某个能力,而是从通用契约出发,用覆盖矩阵定位,再读固定提交的源码解读,得出有据的差距记录。
Dawn 基线不是上游最新版本;Horizon 4.2.0 是 2026-10-07 核对时的上游最新提交,之后上游仍会更新。任一基线升级前,差距记录需要重新对照源码。
按顺序阅读与检查
确认研究方法与基线要求
必读 · Shopify 官方主题解析:Dawn 与 Horizon
完成检查:能说明为何结论只对固定提交成立。
学习源码阅读方法
必读 · Horizon 源码阅读:固定版本、条件分支与证据边界
完成检查:能校核版本、条件分支与既有结论。
理解功能模块契约
必读 · 功能模块模式:信息来源 × 展现或交互
完成检查:能说出模块的信息来源、展现与页面语境。
读通用契约:集合浏览与筛选
必读 · 集合浏览与筛选模块:结果、筛选、排序与翻页
完成检查:能列出契约的状态与验证要求。
用覆盖矩阵定位实现
必读 · Dawn 与 Horizon 对通用展现和功能模块的覆盖矩阵
完成检查:能说出哪个主题在哪篇解读里覆盖了该模块,哪些是未找到。
读 Dawn v15.3.0 的实现
必读 · Dawn 筛选、排序与分页:分区请求、URL 与移动抽屉
完成检查:能列出主题做到与没做到的契约条目。
读 Horizon 4.2.0 的实现
必读 · Horizon 筛选、排序与分页:分区刷新、URL 状态与无限滚动
完成检查:能列出与 Dawn 的实现差异。
选读:换一个模块重复一遍
选读 · 购物车摘要模块:从行项目到结账入口
完成检查:用购物车摘要契约对照两个主题的购物车实现。
选读:Dawn 购物车抽屉
选读 · Dawn 购物车:抽屉、加购通知与购物车页的更新链
完成检查:把差距写成可复现的验证步骤。
选读:Horizon 购物车
选读 · Horizon 购物车:页面、抽屉与数量更新
完成检查:同上,并对照 Dawn。
完成后应能交付
- 为一个模块(例如筛选与分页、购物车)写出差距记录:契约要求、Dawn 实现、Horizon 实现、未核验项。
- 所有「主题未内置」的结论都附全仓库搜索词,并写明适用的提交。