如何排查TypeScript报错：Cannot redeclare block-scoped variable 'length'

1. 检查TypeScript配置的lib选项 #

• 打开tsconfig.json，查看compilerOptions.lib字段，确认是否同时引入了可能冲突的库（比如dom和某些第三方全局类型库）。
• 临时移除dom库，重新编译，看报错是否消失，以此确认冲突是否来自DOM库与其他库的类型重叠。

2. 全局搜索重复声明语句 #

• 在IDE（如VS Code）中全局搜索declare var length: number，覆盖项目src目录和node_modules文件夹，定位所有出现该声明的位置。
• 也可以用命令行快速扫描：

  grep -r "declare var length: number" ./node_modules
  

3. 排查第三方依赖的类型冲突 #

• 执行yarn list查看所有依赖版本，重点关注@types/*系列包，检查是否有版本不兼容导致的全局类型重复。
• 尝试逐个移除近期新增的依赖，重新执行yarn install后编译，定位是否是某个依赖引入了冲突的类型声明。

4. 清理依赖缓存并重新安装 #

• 执行以下命令彻底清理依赖后重装，排除缓存或安装损坏导致的问题：

  rm -rf node_modules yarn.lock
  yarn cache clean
  yarn install
  

5. 检查NestJS项目的类型配置 #

• 确认tsconfig.json的include和exclude字段是否正确，避免意外包含node_modules下的类型文件导致重复加载。
• 查看typeRoots配置，确认是否有自定义全局类型目录与默认TypeScript库类型冲突。

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