如何解决TypeScript中Cannot redeclare block-scoped variable 'mongoose'错误？

出现这个错误的核心原因是：在TypeScript中，使用CommonJS的require语法且文件未被正确识别为模块时，变量会被提升到全局作用域，多个文件声明同名变量就会触发冲突。以下是几种可行的解决方法：

• 改用ES模块导入语法
  TypeScript优先推荐ES模块的import语法，这种方式下每个文件的变量都是模块局部作用域，不会产生全局冲突。将两个文件中的代码替换为：

  import mongoose from 'mongoose';
  

  同时确保tsconfig.json的compilerOptions里，module设置为ESNext/CommonJS，moduleResolution设置为NodeNext/Node16，保证模块解析逻辑正常。

• 强制文件作为模块处理（适配CommonJS）
  如果坚持使用require，可以通过以下方式让TypeScript将每个文件识别为独立模块：

  1. 在tsconfig.json的compilerOptions中设置isolatedModules: true，强制所有文件按模块处理；
  2. 或者在每个文件的顶部添加空的导出语句：

     export {};
     

  这样const mongoose会被限定在当前文件的模块作用域内，不会触发全局重复声明错误。

• 抽离mongoose实例到单独模块复用
  更优雅的做法是把mongoose实例抽成独立模块，其他文件直接导入复用，既避免重复声明，又统一管理实例：

  1. 创建mongooseInstance.ts文件：

     import mongoose from 'mongoose';
     // 可在此提前配置数据库连接逻辑
     export default mongoose;
     

  2. 在dbConn.ts和userSchema.ts中导入该实例：

     import mongoose from './mongooseInstance';
     

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