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拼错或缺失,构建阶段被直接跳过
处理步骤#
- 把结构改成
extensions/<name>/下直接放 toml,不再嵌套 - 打开该 toml,确认
name存在且type = "theme" - 检查 app.toml 是否自定义了
extension_directories,先注释掉恢复默认 - 执行
shopify app info,看 Extensions 段是否列出该扩展 - 仍为空时加
--verbose部署,观察 CLI 实际扫描的路径
验收标准#
shopify app info 的 Extensions 段出现该扩展,deploy 日志里有对应的构建输出。
本文由 风格技术 技术团队整理,适用于 Shopify 标准版与 Plus 店铺。Shopify 平台能力迭代较快,具体操作路径与字段以官方文档和店铺后台实际版本为准。