运行npm run dev时遇Shopify主题扩展报错：command extension:serve not found

算力阿峰

2026-8-3

解决Shopify React+Node.js模板中npm run dev报“command extension:serve not found”的问题

检查package.json的scripts配置
打开项目根目录的package.json，查看scripts里的dev命令是否引用了未定义的extension:serve。如果dev命令是类似npm run extension:serve，但scripts里没有extension:serve字段，需要补充正确的命令。比如Shopify官方模板的标准配置通常会包含：
```
"scripts": {
  "dev": "shopify app dev",
  "extension:serve": "shopify extension serve"
}
```
或者直接将dev命令替换为Shopify CLI的启动指令shopify app dev。
确保Shopify CLI已正确安装
全局安装Shopify CLI：
```
npm install -g @shopify/cli
```
或本地项目安装：
```
npm install @shopify/cli --save-dev
```
安装完成后重新执行npm run dev。
重新安装项目依赖
删除项目根目录的node_modules文件夹和package-lock.json文件，然后执行：
```
npm install
```
依赖安装完成后再次尝试启动项目。
确认模板文件完整性
如果是克隆的官方模板，检查是否有文件缺失。可以重新拉取官方模板初始化项目：
```
npx @shopify/cli app init --template react
```