使用nuxi CLI执行Nuxt generate命令在Netlify失败但本地运行正常

你遇到的报错不是Nuxi找不到，从日志可以看到Nuxi已经正常启动了，报错的核心是Nuxt Bridge默认启用了TypeScript兼容能力，哪怕是纯JS项目也会尝试生成临时的/.nuxt/tsconfig.json文件，Netlify构建环境因为环境差异导致这个文件没有正常生成，从而触发错误。

解决方案 #

按优先级从高到低尝试即可：

1. 禁用Nuxt Bridge的TypeScript自动支持 #

这是最适配纯JS项目的方案，在你的nuxt.config.js中添加如下配置即可：

export default {
  // 你现有的其他配置
  bridge: {
    // 关闭TypeScript相关能力，不会再尝试生成/读取tsconfig文件
    typescript: false
  }
}

2. 显式安装Nuxi依赖 #

本地能正常运行大概率是你全局安装了Nuxi，Netlify构建环境没有全局Nuxi，且你当前的依赖中没有显式声明Nuxi，执行以下命令将Nuxi加入开发依赖：

npm install -D nuxi

3. 统一Netlify和本地的Node版本 #

Netlify默认Node版本可能和你本地的14.17.3不一致，会导致依赖安装异常，任选一种方式指定版本即可：

• 在项目根目录新建.nvmrc文件，内容写14.17.3
• 或者在Netlify控制台的环境变量配置中，添加NODE_VERSION变量，值设为14.17.3

4. 调整构建命令 #

修改脚本避免旧缓存影响构建：

• 可以修改package.json的scripts：

"generate": "nuxi cleanup && nuxi generate"

• 或者直接在Netlify控制台将构建命令设置为npm ci && npm run generate，npm ci会严格按照lock文件安装依赖，比默认的npm install稳定性更高。

5. 临时兜底方案 #

如果上述配置还是报错，可以在项目根目录手动新建一个空的tsconfig.json文件，内容如下，Nuxt运行时会自动覆盖这个文件的配置：

{}

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