Shopify 应用与扩展

extensions 目录里的扩展 CLI 识别不到

现象#

extensions/ 下明明有 theme 扩展目录,shopify app deploy 却只输出 No extensions found,Dev Dashboard 里也看不到扩展。

原因#

  • 扩展目录缺 shopify.extension.toml,CLI 不会把它识别为扩展
  • app.toml 自定义过 extension_directories,默认目录不再扫描
  • 目录多套了一层,如 extensions/theme/ext/,扫描只认第一层
  • toml 里 type 拼错或缺失,构建阶段被直接跳过

处理步骤#

  1. 把结构改成 extensions/<name>/ 下直接放 toml,不再嵌套
  2. 打开该 toml,确认 name 存在且 type = "theme"
  3. 检查 app.toml 是否自定义了 extension_directories,先注释掉恢复默认
  4. 执行 shopify app info,看 Extensions 段是否列出该扩展
  5. 仍为空时加 --verbose 部署,观察 CLI 实际扫描的路径

验收标准#

shopify app info 的 Extensions 段出现该扩展,deploy 日志里有对应的构建输出。

本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。