Shopify CLI 3.0构建主题应用扩展失败及扩展不显示问题咨询

问题1：新增空JS/liquid文件触发构建失败，theme-check返回exit code 1 #

这个报错是theme-check对主题扩展的合法文件校验拦截导致，空文件会被直接判定为无效资源，按以下步骤修复：

• 不要新增0字节的空文件：blocks目录下的liquid文件必须包含合法的schema结构，哪怕是测试用的最小block也要符合格式要求，参考最小合法示例：

{% comment %} 测试功能块 {% endcomment %}
{% schema %}
{
  "name": "测试块",
  "target": "section",
  "javascript": "your-js-file.js",
  "settings": []
}
{% endschema %}

• assets目录下新增的JS/CSS等资源文件不能完全为空，最少添加一行注释（比如// theme extension logic）即可绕过空文件校验规则。
• 如果补全内容后还是报错，直接在扩展目录执行shopify extension check命令，会输出具体的校验不通过项，不用只看build返回的笼统错误信息。
• 旧版本Shopify CLI 3.x存在theme-check校验bug，执行npm run shopify upgrade升级到最新稳定版即可解决大部分无明确原因的校验报错。

问题2：开启开发者预览后主题编辑器找不到对应扩展 #

按以下顺序排查配置问题：

• 启动开发服务（执行npm run dev）后，必须点击终端输出的预览链接，手动选择要挂载扩展的目标店铺、目标主题，跳过这一步主题不会加载开发态扩展。
• 检查扩展根目录的shopify.extension.toml配置，确认type字段值为theme_app_extension，类型配置错误的扩展不会出现在主题编辑器的应用列表里。
• 核对block/embed的target配置：要出现在App embeds面板的扩展，schema里的target值必须是app_embed；要出现在区块添加面板的普通block，target值才是section，target配置错误会导致扩展出现在错误的面板、甚至完全不显示。
• 主题编辑器存在强缓存，用无痕模式打开后台，或者执行强制刷新（Mac端按Cmd+Shift+R、Windows端按Ctrl+F5）重新加载编辑器页面，新同步的开发扩展经常需要强制刷新才能加载出来。
• 确认当前登录后台的账号，和你绑定应用、开启预览的店铺所属账号一致，没有切错店铺身份。

内容的提问来源于stack exchange，提问作者Omer