使用create-next-app启动服务器时出现错误

以下是针对该问题的具体排查和解决步骤：

• 清理Next.js缓存
  直接删除项目根目录下的.next文件夹，或者执行命令清理缓存后重启服务：

  rm -rf .next && npm run dev
  

  缓存残留是切换TS/非TS环境后常见的问题，清理后能排除旧配置干扰。

• 重置ESLint配置
  检查项目根目录的.eslintrc.json，将其替换为Next.js官方默认的TS+ESLint配置：

  {
    "extends": ["next/core-web-vitals", "next/typescript"]
  }
  

  自定义的ESLint规则可能与Next.js的TS配置冲突，重置后能快速定位问题。

• 校验TypeScript配置
  确保tsconfig.json的compilerOptions符合Next.js要求，示例配置如下：

  {
    "compilerOptions": {
      "target": "es5",
      "lib": ["dom", "dom.iterable", "esnext"],
      "allowJs": true,
      "skipLibCheck": true,
      "strict": true,
      "forceConsistentCasingInFileNames": true,
      "noEmit": true,
      "esModuleInterop": true,
      "module": "esnext",
      "moduleResolution": "node",
      "resolveJsonModule": true,
      "isolatedModules": true,
      "jsx": "preserve",
      "incremental": true
    },
    "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
    "exclude": ["node_modules"]
  }
  

  错误的TS配置会导致启动时类型检查失败。

• 锁定依赖版本创建项目
  若最新版create-next-app存在兼容性问题，尝试使用指定稳定版本创建项目：

  npx create-next-app@13.4.0 my-app --typescript --eslint
  

  创建完成后再执行npm install确保依赖版本匹配。

• 检查Node.js版本
  Next.js要求Node.js为18.17.0或更高LTS版本，使用node -v检查当前版本，若版本过低，通过nvm切换到符合要求的版本：

  nvm install 18 && nvm use 18
  

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