shopify app deploy 成功但扩展还是旧的

现象#

shopify app deploy 输出成功，Dev Dashboard 里新版本也变成 Active，但店铺前台的应用区块还是旧文案，刷新和换浏览器都一样。

原因#

• 主题 JSON 保存的是旧 block 实例，扩展改了 schema 后该实例的设置项不会自动补齐
• 改过扩展目录名或 toml 里的 handle，旧 block 找不到对应扩展
• 版本发布后推送到各店铺需要几分钟，期间仍渲染上一版
• 只改了本地文件没有 deploy，dev 店铺看到的是本地开发版本

处理步骤#

1. 确认新版扩展的 handle 与旧版一致，再刷新主题编辑器
2. 若改过目录名，把 extensions/<name> 改回原值再部署
3. 在主题编辑器删除旧 block，重新从应用区块列表拖入一次
4. 执行 shopify app deploy 后等待几分钟，再打开前台
5. 查看页面源码里扩展输出的标记，确认文案已换成新版本

验收标准#

主题编辑器里 block 无 app not found 提示，前台源码中的文案与新版本一致。