Next.js项目迁移TypeScript：自动生成的tsconfig.json缺失moduleResolution报错

问题背景 #

把现有Next.js项目转TypeScript，执行npm install --save-dev typescript @types/react @types/node装完依赖后，自动生成的tsconfig.json出现报错：The automatically generated tsconfig.json file is missing moduleResolution

快速解决 #

直接在tsconfig.json的compilerOptions区块里补上moduleResolution配置即可，分两种场景适配：

• Next.js 13+（含App Router）：官方推荐用bundler，适配新的打包逻辑

  {
    "compilerOptions": {
      // 保留原有其他配置
      "moduleResolution": "bundler"
    },
    "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
    "exclude": ["node_modules"]
  }
  

• Next.js 12及更早版本：用node适配旧的模块解析逻辑

  {
    "compilerOptions": {
      // 保留原有其他配置
      "moduleResolution": "node"
    },
    "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
    "exclude": ["node_modules"]
  }
  

验证步骤 #

修改完成后保存tsconfig.json，重启开发服务器（npm run dev），报错即可消失。如果仍有问题，检查Next.js与TypeScript的版本是否兼容，建议使用Next.js官方推荐的TypeScript版本。

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