Theme App Extension 部署成功但区块列表没有怎么办

现象#

应用已部署，shopify app deploy 也成功，但在主题编辑器的「应用区块」里找不到自己的 block，或 App Embed 开关是灰的。

原因#

• App Extension 只在开发店铺可见，未发布版本不会同步到其它店铺
• 扩展目录结构不符合要求，缺少 blocks/ 下的 liquid 文件或 shopify.extension.toml 里的 type 写错
• 店铺未安装该应用，或安装的是另一个应用版本
• 主题不是 Online Store 2.0，App Embed 无法挂载

处理步骤#

1. 确认当前店铺就是应用安装店铺，并在 shopify.app.toml 里配置了正确域名
2. 检查扩展目录：extensions//blocks/*.liquid 存在，且 toml 中 type = "theme"
3. 重新执行 shopify app deploy 发布新版本，再到店铺里重装或刷新应用
4. 确认主题支持 2.0：主题代码里存在 templates/*.json

验收标准#

编辑器侧栏出现应用区块，拖入后前台能渲染出扩展内容。