Shopify 主题代码修改指南:改 Liquid 前,先给自己留好退路
很多人第一次动 Shopify 主题代码,起因都很小:一句在后台找不到开关的文案、一块怎么调都不顺眼的排版。真正让人停手的不是「会不会写」,而是「万一改坏了,店铺打不开怎么办」——主题文件直接决定顾客看到什么、能不能顺利下单。
也正因如此,改代码可以被安排得很安全,顺序是:先确认需求真的需要动代码;动手前把备份、副本、台账三条退路备好;只在未发布的主题上改,用预览链接验收;出问题按三层回滚处理。后台入口名称会随版本调整,以你的实际显示为准。还在起步阶段的卖家,可以先开通免费试用把店搭起来再对照练手。
一、先判断:这个需求要不要改代码
大部分「看起来必须改代码」的需求,后台就能解决。先按四条路排除:配色、字体、板块顺序这类,主题编辑器里有开关,做法见主题装修指南;商品页要多一张尺码表、一段材质说明,用 Metafields 存内容再在区块里选出来,见Metafields 元字段设置指南;推荐位、筛选、评价展示这类功能,先去应用市场找现成方案,见应用安装指南;按钮和提示文字,走「编辑默认内容」或语言文件替换,不必写进模板。
排除完还剩下的那部分,才真的轮到代码。判断口径是一句话:万一改错,顾客是「看到的东西有点乱」,还是「付不了钱」?前者可以慢慢试,后者最好换做法。涉及结账、支付、库存写入、价格计算的,优先用官方能力和应用,不建议自己写脚本硬改;新版结账能改的范围以套餐和结账版本为准。
二、动手前的三件保命事
这三件事加起来不到二十分钟,却决定改坏之后你是五分钟内恢复,还是整站重搭。
- 下载主题备份。在主题列表里对当前主题的管理菜单选择下载主题文件,你会拿到一个含全部模板与资源的压缩包。存到自己电脑并按日期命名,这是你唯一完全掌控的退路,全局思路见数据备份与安全设置指南。
- 复制一份未发布主题。同一菜单里选择复制主题,得到与线上一致、状态为「未发布」的副本。之后所有改动只发生在它身上:顾客看不到它,改坏也不必救火,只要不点发布。
- 建一张改动台账。一行一条,字段够用就行:日期、文件名、改了什么、为什么改、怎么回滚。它在回滚和主题更新时都会用到。
多人运营时,「修改主题」权限只给确实需要的人,见团队协作与权限管理指南。再定一条规矩:大促当天与旺季高峰不改代码,改动窗口提前排进日历,节奏对照黑五网一备战指南。
三、用对入口:副本主题与预览链接
在副本主题的菜单里选择编辑代码会进入文件树。目录不用全认识,先记住六个位置:
- Layout:全站骨架,改动影响面最大;
- Sections:区块,多数小改动落在这里;
- Templates:页面模板,决定哪类页面出现哪些区块;
- Snippets:可复用片段;
- Assets:样式表与脚本;
- Locales:界面文案的出处。
定位文件别靠猜。在主题编辑器里选中那个区块,用「查找文件」或「在编辑器中打开代码」一类的入口,它会直接跳到对应文件。同一个商品页常存在多个模板,改错一个文件、线上看起来「完全没生效」,是最常见的假故障。
看效果用预览:后台点预览后,地址里会带上标识工作主题的参数,把链接发到手机就能在真实设备上检查排版。文案改动优先写进语言文件或「编辑默认内容」,别硬编码在模板里,否则做多语言时会漏翻,见多语言多币种设置。
四、看懂 Liquid 的最小三件套
Shopify 主题用 Liquid 模板语言,读懂现有代码只需要三样:两个花括号负责输出,把标题、价格、图片这类对象打到页面上;百分号花括号里的标签负责逻辑,比如「有库存才显示这句提示」「循环展示合集里的商品」;竖线后面是过滤器,把金额格式化、把图片切成合适尺寸、把文字指向语言键。
HTML 和 Liquid 混着写,所以第一次读文件先找 HTML 结构,再找插进去的判断语句,比逐行啃快得多。常见小改动大致五类:输出一行 Metafield 内容、替换一句按钮文案、给区块加一个后台可控的显示开关、给图片补替代文本的兜底逻辑、在自定义样式里加几行 CSS。
三个「不要」同样重要。不要直接改主题自带的主样式表和主脚本——主题一更新就被覆盖,单独加自定义样式更稳。不要粘贴自己读不懂的代码块,尤其当它引用了当前主题并不存在的对象。别让应用在未经确认的情况下往主题里写大段脚本,装完回文件树看它改了哪些位置并记进台账:脚本每多一段,页面就慢一点,取舍参考站点速度优化清单。
五、改完做六项回归验证
「看起来没问题」和「验证过」是两件事,六项按顺序过:
- 手机与桌面各一遍,看真实字号、折叠位置和按钮热区;
- 关键页面全打开,首页、合集页、商品页(带变体与单变体各挑一个)、购物车、结账页、订单确认页;
- 把状态打乱,登录与未登录、售罄与有库存、有无折扣——展示逻辑常在这些分支上出错;
- 切换语言与币种,硬编码的文字最容易在这一步露出来;
- 下一笔测试单,从加购走到付款,顺带看看失败时后台留下了什么,见付款失败挽回指南;
- 看报错与速度,控制台有没有红字,改后首屏是不是明显比改前慢;记得先刷新预览或清缓存再看,别把「没生效」当成「改了没用」。
六、出问题怎么回滚,主题更新怎么办
回滚有三层,从轻到重:恢复单个文件,从备份包里取出同名文件覆盖回去,或照台账把那一处改回来,影响面只在某个板块时这层就够;切换发布,在后台把原来那份主题重新发布,线上立刻回到改动前,副本留着慢慢排查,不必在顾客眼皮底下试错;彻底重置,删掉被改乱的副本,重新上传备份包得到干净副本,再按台账重做要保留的改动。
找支持之前,备好出错页面的链接或试用店地址、复现步骤和报错截图,并说明改了哪个文件的哪一处。主题本身的问题走官方支持渠道,应用造成的冲突同时找开发者。还有一件能让人冷静的事实:主题文件与商品、订单、顾客数据分开存放,代码改坏通常表现为显示异常,不会把货和数据一起弄丢。
长期原则是把改动做小、做在有明确位置的地方。主题有大更新时,先在未发布的副本上更新,对照台账复验自定义是否还在,把第五节的六项回归再过一遍,确认没问题再切换发布;台账里已失效的自定义每季度清一次,顺手排进每天 30 分钟运营 SOP。
七、十条自查
- 需求已排除过主题设置、Metafields、应用、语言文件四条路;
- 有当前主题的完整导出备份,文件名带日期;
- 改动只发生在未发布的副本主题上;
- 有一张改动台账,含文件、原因与回滚方式;
- 「修改主题」权限只给确实需要的人;
- 用预览链接在手机与桌面各看过一遍;
- 下过测试单,不是只看首页效果;
- 没有直接改主题自带的主样式表和主脚本;
- 知道三层回滚怎么操作,并在试用环境练过;
- 主题更新前会在副本主题上先复验自定义。
写在最后
改代码属于独立站运营里低频但高风险的动作,值得为它固定一套流程:先判断该不该改,再备份、复制、留台账,改完用预览链接验证,出错按三层回滚。做顺之后你会发现,绝大多数需求根本走不到改代码这一步——这也正是不懂技术也能把店开好的原因。如果还没把店铺搭起来,可以用免费试用先练手:在副本主题上改,改坏就删掉重来。