ts-node/ts-node-dev编译失败但tsc成功的问题排查方法

1. 检查TypeScript配置文件的类型路径配置 #

• 确保tsconfig.json的typeRoots或include字段包含自定义类型目录src/@types，避免ts-node-dev无法识别自定义类型：

  {
    "compilerOptions": {
      "typeRoots": ["./node_modules/@types", "./src/@types"],
      "include": ["src/**/*"]
    }
  }
  

2. 确认自定义类型文件的声明语法正确 #

• 检查src/@types/index.d.ts的结构，必须将扩展声明包裹在Express命名空间内，同时确保User实体的导入路径正确：

  import { User } from '../entities/User'; // 路径需匹配你的实体文件位置
  
  declare namespace Express {
    interface Request {
      requester?: User;
    }
  }
  

3. 强制ts-node-dev读取指定的tsconfig.json #

• 启动服务时显式指定配置文件，避免ts-node-dev使用默认配置忽略自定义类型：

  ts-node-dev --respawn --transpile-only --project tsconfig.json src/index.ts
  

4. 清除ts-node-dev缓存并重启 #

• ts-node-dev会缓存编译结果，旧的类型定义可能残留导致报错，可通过以下方式清除：

  # 停止服务后删除缓存目录
  rm -rf node_modules/.cache
  # 或启动时禁用缓存
  ts-node-dev --respawn --no-cache src/index.ts
  

5. 验证版本兼容性 #

• 当前使用的ts-node-dev@2.0.0与typescript@5.4.5可能存在兼容性问题，可尝试调整版本：

  # 降级TypeScript或升级ts-node-dev
  npm install typescript@5.3.3 ts-node-dev@latest
  

6. 检查类型文件的命名与位置 #

• 确保自定义类型文件为.d.ts后缀，且放置在src/@types目录下，避免与业务代码文件混放导致ts-node-dev识别异常。

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