Nuxt3部署至Azure Static Web Apps时报@nuxt/kit未安装错误

错误根因 #

该报错是@nuxt/kit依赖缺失导致，触发场景有两个：一是Nuxt3相关依赖未完整安装，二是Azure Static Web Apps 默认构建流程会跳过开发依赖安装，而Nuxt3的构建工具依赖默认放在开发依赖中导致找不到包。

解决步骤 #

• 第一步：显式安装@nuxt/kit到生产依赖
  本地项目根目录执行命令：

  npm install @nuxt/kit --save
  

  不要将该包放在开发依赖中，也不要后续卸载，nuxi 运行强制依赖该包，卸载后本地和线上都会报错。
• 第二步：修正Azure工作流配置
  打开你仓库里的.github/workflows下的Azure静态应用部署yml文件，在构建步骤的环境变量中添加NODE_ENV: development，确保构建阶段会安装全部依赖，示例配置参考：

  - name: Build And Deploy
    env:
      NODE_ENV: development # 新增这行
    with:
      # 你原来的配置保持不变
      app_location: "/"
      api_location: ""
      output_location: ".output/public"
  

• 第三步：清理依赖缓存重新测试
  本地删除node_modules文件夹和package-lock.json文件，重新执行npm install，再本地跑npm run build确认无报错后，把改动推送到GitHub触发自动部署即可。
• 可选兜底方案：如果修改后还是报错，把package.json中devDependencies里的nuxt3移到dependencies里，再重新推送代码。

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