顾客账户 UI 扩展部署成功却不显示怎么办

现象#

shopify app deploy 显示部署成功，但顾客登录后在 /account 的 Profile 页找不到自定义区块，checkout and accounts editor 里也搜不到这个 app block。

原因#

• 商店仍是 legacy customer accounts，这类页面根本不加载 UI extension，部署成功也没有落点
• 扩展只是发布了，商家没在账户编辑器里把 block 加到具体页面，默认不会自动出现
• 同一个 block target 最多放三个扩展，槽位已被其他应用占满，新的 block 加不进去
• toml 里声明的 target 与页面不匹配，比如把 order status 的 target 用在 profile 页上

处理步骤#

1. 查 Admin API 的 CustomerAccountsV2，看 customerAccountsVersion 是否为新版本
2. 打开 Settings > Checkout > Customize，选 Profile 页后点 Add block 添加该扩展
3. 核对 [[extensions.targeting]] 里的 target 与 module，两者必须成对出现
4. 运行 shopify app dev 在开发店预览，看 console 里是否有 network_access 或 scope 报错
5. 确认线上店铺装的是刚发布的 app 版本，旧版本不会带上新 extension

验收标准#

测试顾客登录后在 Profile 页能看到该区块，编辑器里 block 名称与 toml 中 name 字段完全一致。