NestJS应用start:dev启动失败：停在Starting incremental compilation，仅watch模式异常

• 检查TypeScript配置

  • 确认tsconfig.json中的incremental字段是否设为true，若为true可改为false后重试，增量编译可能与watch模式存在冲突。
  • 同时核对outDir和rootDir配置，确保输出目录与源码目录无重叠，避免编译时出现文件锁定问题。

• 清理缓存文件

  • 删除项目根目录下的dist文件夹与.tsbuildinfo文件，这类缓存文件可能引发增量编译异常。
  • 执行对应命令：

    # Linux/macOS
    rm -rf dist .tsbuildinfo
    # Windows
    rmdir /s /q dist && del .tsbuildinfo
    

• 升级Nest CLI及相关依赖

  • 版本兼容性问题可能导致该异常，升级Nest CLI至最新稳定版：

    npm install -g @nestjs/cli@latest
    

  • 同步更新项目内核心依赖：

    npm install @nestjs/core@latest @nestjs/common@latest typescript@latest ts-node@latest
    

• 调整start:dev命令配置

  • 尝试显式禁用增量编译，修改package.json中的scripts：

    "scripts": {
      "start:dev": "nest start --watch --no-incremental"
    }
    

  • 或改用ts-node-dev替代默认watch机制，先安装依赖：

    npm install ts-node-dev --save-dev
    

    再修改scripts：

    "scripts": {
      "start:dev": "ts-node-dev --respawn --transpile-only src/main.ts"
    }
    

• 检查文件系统权限

  • 确保项目目录具备完整读写权限，watch模式需要监听文件变化，权限不足会导致监听失败进而卡住编译。
  • 避免在系统保护目录（如Windows的Program Files、Mac的/Applications）下运行项目。

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