TypeScript命名空间跨文件分组实现方法咨询

我懂你从Java转TypeScript时的这种困惑——Java里的包/命名空间跨文件合并很直观，但TS的命名空间机制确实有自己的玩法，之前你遇到的重复标识符、重复导出问题，大多是因为没找对跨文件扩展命名空间+统一导出的正确姿势。下面我给你一步步拆解实现方案：

1. 分文件扩展同一个命名空间 #

首先，在各个类文件里，直接扩展MySpace命名空间，不要在每个文件单独导出这个命名空间，因为我们要让这些文件的代码共同构建同一个全局命名空间：

SpaceConverter.ts #

namespace MySpace {
  export class SpaceConverter1 {
    convert(value: number): string {
      return `Space converted: ${value}`;
    }
  }
}

TimeConverter.ts #

namespace MySpace {
  export class TimeConverter1 {
    convert(value: number): string {
      return `Time converted: ${value}`;
    }
  }
}

这里的核心是：每个文件里的namespace MySpace会自动合并到同一个命名空间下，不需要额外的导出语句，导入文件时会自动执行代码扩展命名空间。

2. 创建统一入口文件 #

接下来创建myNameSpace.ts作为单入口，负责导入所有分文件的命名空间实现，然后统一导出MySpace：

// 导入所有扩展MySpace的文件（仅执行代码，无需解构）
import './SpaceConverter';
import './TimeConverter';

// 导出合并后的MySpace命名空间
export { MySpace };

这一步解决了你想要的单路径导入需求——外部只需要导入这个入口文件，就能拿到完整的MySpace。

3. 外部使用方式 #

现在在其他业务文件里，就可以轻松单路径导入并实例化类了：

import { MySpace } from './myNameSpace';

// 直接使用命名空间下的类
const spaceConv = new MySpace.SpaceConverter1();
console.log(spaceConv.convert(200)); // 输出: Space converted: 200

const timeConv = new MySpace.TimeConverter1();
console.log(timeConv.convert(120)); // 输出: Time converted: 120

为什么之前的方法会报错？ #

• 如果你在每个分文件里都写export namespace MySpace，那么每个文件都会导出一个独立的MySpace，导入时自然会提示标识符重复；
• 使用export *的话，同样是因为每个文件的MySpace被单独导出，合并时会冲突。而我们上面的方式是利用TS的命名空间自动合并特性，让所有分文件共同构建同一个命名空间，再通过入口统一导出。

补充：TS配置注意事项 #

确保你的tsconfig.json里的模块配置支持这种写法，比如：

{
  "compilerOptions": {
    "module": "ESNext",
    "moduleResolution": "Node",
    "target": "ES6",
    "outDir": "./dist",
    "strict": true
  }
}

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