Nuxt3项目中nuxt.config.ts及tsconfig.json的TypeScript报错排查

错误1：Type instantiation is excessively deep and possibly infinite.ts(2589)（modules字段报错） #

原因 #

你使用的Nuxt 3.1.0版本与@nuxtjs/apollo@5.0.0-alpha.5（Alpha测试版）的类型定义存在兼容性冲突，加上Nuxt 3早期版本类型系统本身的不完善，导致TypeScript推导模块类型时陷入无限循环，触发类型实例化过深的错误。

解决方法 #

• 升级Nuxt到稳定新版本：执行命令npm install nuxt@latest --save-dev，新版本修复了大量类型相关Bug，能更好兼容各模块。
• 替换/升级不稳定模块：若升级Nuxt后问题仍存在，可尝试将@nuxtjs/apollo替换为稳定版本，或等待其发布正式版；临时调试时可在modules字段行上方添加// @ts-ignore忽略该错误（不推荐长期使用）。
• 调整TypeScript严格模式：在nuxt.config.ts的typescript配置中，暂时关闭strict选项，或单独禁用strictFunctionTypes、strictNullChecks等子选项（妥协方案，仅临时应急）。

错误2：Cannot find type definition file for 'node'（tsconfig.json报错） #

原因 #

TypeScript需要Node.js的类型定义文件来识别Node环境API，但你的项目未安装@types/node依赖，而Nuxt自动生成的tsconfig.json默认包含node类型库，导致找不到对应类型文件。

解决方法 #

执行以下命令安装Node.js类型定义包：

npm install @types/node --save-dev

安装完成后，TypeScript即可找到对应类型文件，错误自动消失。

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