大多数定制 Shopify 主题都从复制 Dawn 开始。它免费、快速,并由 Shopify 维护。但 Leafwise 是我们在自家商店出售的苗圃和植物店主题,这条路对我们走不通。
下面介绍我们如何从零编写 Shopify 主题:为什么没有基于 Dawn、主题如何组织,以及在得到干净的 Theme Check 结果之前遇到的工具问题。
关于本文:Leafwise 是我们自己的产品,所有内容都来自真实项目。代码示例经过缩短,并非虚构。

为什么不基于 Dawn?
Dawn 的许可证允许在其基础上开发,但由 Dawn 派生的主题只能通过 Shopify 主题商店分发。我们想用自己的价格和许可证直接出售 Leafwise,这意味着完全不能使用 Dawn 的代码:区块结构、JavaScript 和 CSS 都不行。
从空文件夹开始也有好处。每个区块都因为植物店需要而存在,没有任何服装店遗留下来的东西。
一段话说清架构
Leafwise 是一个简洁的 Online Store 2.0 主题:JSON 模板、页眉组和页脚组,以及到处可用区块的分区。七套配色放在一个配色组里,一个 snippet 把每套配色转换成带自定义属性的 CSS 类,任何分区只需一个设置就能切换配色。没有框架,也没有构建步骤。交互部分是四个延迟加载文件里的小型自定义元素。
side-drawer和cart-drawer:菜单、搜索和购物车product-form、variant-picker、media-gallery和sticky-atc:商品页facets-area:无需刷新的筛选;predictive-search:搜索建议plant-quiz和filter-tabs:首页
购物车:一次请求,更新所有分区
加入购物车时,侧边购物车、页眉数量和手机导航必须同时更新。Section Rendering API 在同一次请求里完成:我们请 Shopify 渲染需要的分区,然后替换它们的 HTML。
formData.append('sections', 'cart-drawer,cart-count');
formData.append('sections_url', window.location.pathname);
const res = await fetch('/cart/add.js', { method: 'POST', body: formData });
const data = await res.json();
// data.sections['cart-drawer'] is fresh HTML for the drawer
每个显示购物车数据的元素都带有 data-cart-section 属性,所以新增显示购物车的位置只需要加这个属性,不必写新的 JavaScript。
Theme Check 显示“0 files inspected”
在 Windows 上,shopify theme check 无论在哪个文件夹运行都没有报错,却显示检查了零个文件。什么都没检查的“干净”结果比报错更糟。于是我们改为直接通过 Node 包调用同一个检查器:
const { themeCheckRun } = require('@shopify/theme-check-node');
const { offenses, theme } = await themeCheckRun(root, undefined, console.error);
console.log('Files inspected:', theme.length);
它找到一个错误和四个警告,其中包括一个过长的分区名称。修复后:90 个文件,0 个错误,0 个警告。
可能被 Shopify 拒绝的压缩包
PowerShell 的 Compress-Archive 生成的压缩包路径使用反斜杠,即 sections\header.liquid 而不是 sections/header.liquid。一些解压工具和上传检查不接受这种路径。我们改用 .NET 的 ZipArchive,并自己用正斜杠写入每个路径。
$rel = $file.FullName.Substring($src.Length + 1).Replace('\', '/')
[IO.Compression.ZipFileExtensions]::CreateEntryFromFile($zip, $file.FullName, $rel)
下次还会这样做的事
- 不用框架:四个小脚本文件比任何打包文件加载更快,也更易读
- 购物车相关的一切都用 Section Rendering API
- 在 CI 中通过 Node 包运行 Theme Check,没有检查到文件时让构建失败
- 尽早在真实的开发店铺中测试。Theme Check 通过了,店铺仍发现了八个问题,这是我们下一篇文章的主题
Leafwise 在 Charming Theme 出售。如果你需要为自己的店铺从零开发 Shopify 主题,请查看我们的 Shopify 主题开发服务。
常见问题
可以在主题商店之外出售基于 Dawn 的主题吗?
Dawn 的许可证只允许派生主题通过 Shopify 主题商店分发。想在其他地方出售,就要编写自己的代码。
从零编写比修改 Dawn 多花多少时间?
前期更久,因为购物车、筛选和款式逻辑都要自己写。好处是每一行代码都属于你,也没有用不上的代码。
现代 Shopify 主题需要构建步骤吗?
不需要。带自定义属性的普通 CSS 加上小型自定义元素,足以满足 Leafwise 的全部需求。