TS2451错误求助：无法重新声明块级作用域变量BaseRepository_1

问题根源 #

该错误源于TypeScript编译CommonJS模块时，对默认导出生成的临时变量名（如BaseRepository_1）在多个文件中重复，导致全局作用域下变量冲突。

解决思路与步骤 #

1. 改用命名导出替代默认导出 #

修改BaseRepository.ts的导出方式，从默认导出改为命名导出：

import knex from "@api/configs/knex.config";
import { Knex } from "knex";

// 移除default，改用命名导出
export abstract class BaseRepository<T> {
  private knex: Knex = null;
  private tableName: string = null;

  constructor(tableName: string) {
    this.knex = knex;
    this.tableName = tableName;
  }

  private get query(): Knex.QueryBuilder {
    return this.knex(this.tableName);
  }

  async find(item: Partial<T>): Promise<T[]> {
    return await this.query.where(item).select();
  }
}

然后在子类（UsersRepository.ts/SalesRepository.ts）中修改导入语句：

// 用命名导入替代默认导入
import { BaseRepository } from "./BaseRepository";

export class UsersRepository extends BaseRepository<User> {
  constructor() {
    super("users");
  }
}

这种方式会让TypeScript生成唯一的变量名，避免重复冲突。

2. 检查并修正tsconfig配置 #

• 添加outDir配置，将编译产物隔离到单独目录，避免与源文件或其他编译文件冲突：

  "compilerOptions": {
    // ... 其他配置
    "outDir": "./dist"
  }
  

• 确认未启用outFile选项：CommonJS模块不支持outFile合并多个文件，启用后会导致变量作用域冲突。
• 检查include和exclude规则，确保没有重复包含同一目录下的文件，比如避免同时包含src/**/*.ts和api/src/**/*.ts中重复的文件。

3. 升级TypeScript版本 #

部分旧版本的TypeScript在处理默认导出的CommonJS模块时存在变量名生成的bug，升级到最新稳定版可以解决这类问题：

npm install typescript@latest --save-dev

4. 检查编译命令 #

确保编译命令没有强制合并多个文件，比如避免使用tsc src/repositories/*.ts这种直接指定多个文件的方式，而是通过tsc直接读取tsconfig配置，让每个源文件单独编译为对应的CommonJS模块。

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