Shopify 知识库 · 指南
Shopify Theme 交付框架：范围、开发与验收
Shopify Theme 交付框架：从产品范围、页面矩阵、模块契约到编辑体验、实现与验收，形成可复查的流程，并说明 Theme Store 清单何时适用。
Theme 交付不是先列完所有文件再逐个开发。它从产品范围和业务页面开始，经过内容、功能模块与页面组合，最后形成 Theme 实现和可重复验收。
交付链路
- 范围：明确主题服务的商家、商品和业务页面，不把临时想法当成功能承诺；
- 页面矩阵：为需要支持的 Template type 记录核心任务、资源上下文和默认页面组合；
- 模块契约：为每个模块记录信息来源、交互、状态、退化与 Theme 映射；
- 编辑体验：只暴露真实商家需要控制的 Section、Block 和 Setting；
- 实现：按 Layout、Template、Section、Block、Snippet 与 supporting files 的职责落地；
- 验证：在固定版本和测试店铺中覆盖内容、编辑器、响应式、无障碍、性能与交易状态；
- 交付记录：保存版本、测试条件、未覆盖范围和回滚或迁移条件。
常见起步设想怎样落地
| 起步设想 | 落地方式 |
|---|---|
| “测试方便、持续集成” | 写成可重复的测试与自动检查要求，工具随具体项目选择 |
| 先定下 Template 数量 | 不预设固定数字；按平台要求与真实产品范围建立页面矩阵 |
| “满足 Theme checklist” | 区分 Theme Store 要求、通用质量目标和本产品验收，不混成一个勾选项 |
| 初始化命令与开发工具配置 | 按当前 CLI 与工具版本核验后再写成操作手册 |
| Vite、Tailwind、组件库与 Custom Elements | 作为候选实现技术，有了产品范围和代码基线再定为架构 |
最小交付矩阵
| 维度 | 至少记录什么 |
|---|---|
| 页面 | Template type、业务页面、主要任务和默认模块序列 |
| 内容与数据 | 权威来源、动态状态、空值、过期与多市场条件 |
| 编辑器 | 可添加、移除、排序、保存、默认值和升级迁移 |
| 交互 | 键盘、焦点、触控、减少动态效果、加载和错误反馈 |
| 交易 | 变体、价格、库存、配送、销售计划、购物车与订单一致性 |
| 质量 | 响应式、无障碍、性能、SEO、翻译与真实设备 |
| 证据 | Theme 版本、测试店铺条件、操作步骤、结果和未覆盖项 |
Theme Store 的 requirements 和测试清单可以作为外部基线，但只有计划提交 Theme Store 时才承担对应准入含义。自用或定制主题仍应选择与真实范围匹配的检查项，不能用“最小化”省略关键购买状态。