NestJS编译耗时超20分钟且热重载失效，求解决方案

问题描述 #

我用nest new new-project创建了一个NestJS项目，但遇到两个核心问题：

• 首次编译耗时超过20分钟
• 热重载无法检测文件变更，保存文件后不会自动重新加载

我已经按照官方热重载配置文档操作，但没有效果，附上我的tsconfig.json配置：

{
  "compilerOptions": {
    "module": "commonjs",
    "declaration": true,
    "removeComments": true,
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "allowSyntheticDefaultImports": true,
    "target": "es2017",
    "sourceMap": true,
    "outDir": "./dist",
    "baseUrl": "./",
    "incremental": true,
    "skipLibCheck": true,
    "strictNullChecks": false,
    "noImplicitAny": false,
    "strictBindCallApply": false,
    "forceConsistentCasingInFileNames": false,
    "noFallthroughCasesInSwitch": false,
    "resolveJsonModule": true,
    "esModuleInterop": true,
  }
}

恳请提供解决思路，谢谢。

解决思路 #

针对编译耗时过长问题 #

• 关闭类型声明生成：当前配置中declaration: true会生成.d.ts类型文件，这会大幅增加首次编译时间。如果不是要发布npm库，直接改为"declaration": false。
• 升级TypeScript版本：旧版TS对装饰器、元数据的处理效率偏低，安装NestJS推荐的TS版本（^4.9.x及以上），执行npm install typescript@latest --save-dev更新。
• 清理编译缓存：删除项目根目录的.tsbuildinfo（增量编译缓存文件）和dist文件夹，避免缓存损坏导致的异常耗时，之后重新编译。
• 合并重复依赖：执行npm ls检查是否有重复或冲突的依赖（尤其是@nestjs和TS相关包），用npm dedupe合并重复依赖，减少编译时的资源消耗。

针对热重载失效问题 #

• 确认启动命令：确保用nest start --watch启动开发服务，或者在package.json的scripts中配置"start:dev": "nest start --watch"，不要用普通的nest start。
• 关闭增量编译：incremental: true的增量编译逻辑可能和热重载的文件监听冲突，尝试改为"incremental": false后重启服务。
• 添加忽略监听目录：在nest-cli.json中配置watchIgnore，排除不需要监听的目录，避免监听过多文件导致检测失效：

  {
    "compilerOptions": {
      "watchIgnore": ["node_modules", "dist", ".git"]
    }
  }
  

• 检查文件权限：确保Node进程有读取项目文件的权限，部分系统下文件只读或权限不足会导致热重载监听失效。
• 替换热重载工具：如果内置热重载仍无效，改用ts-node-dev，执行npm install ts-node-dev --save-dev，然后修改启动脚本为"start:dev": "ts-node-dev --respawn src/main.ts"。

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