如何在多个TypeScript文件中拆分并合并同一个namespace？

可以实现跨多个文件合并同一个命名空间，下面是具体的正确做法及对你之前错误的分析：

正确实现方式（全局命名空间场景） #

如果你的项目采用全局脚本模式（不使用ES Modules的import/export），按以下步骤操作：

1. 分文件定义共享命名空间，不要单独export命名空间本身：

   • parameter1.ts

     namespace Parameters {
       export const parameter1 = {
         param1: 1,
         param2: 2,
         param3: 3,
       };
     }
     

   • parameter2.ts

     namespace Parameters {
       export const parameter2 = {
         param1: 1,
         param2: 2,
         param3: 3,
       };
     }
     

2. 编译时将所有相关文件打包为一个全局脚本：
   使用TypeScript编译命令的--outFile参数，把多个文件合并成一个输出文件，确保命名空间在全局环境中合并：

   tsc --outFile bundle.js parameter1.ts parameter2.ts index.ts
   

3. 在index.ts中直接使用合并后的命名空间：

   console.log(Parameters.parameter1);
   console.log(Parameters.parameter2);
   

模块系统下的替代方案（ES Modules场景） #

如果你的项目使用ES Modules（文件包含import/export），全局命名空间的合并逻辑不适用，可改用对象合并的方式实现类似效果：

• parameter1.ts

  export const parameter1 = {
    param1: 1,
    param2: 2,
    param3: 3,
  };
  

• parameter2.ts

  export const parameter2 = {
    param1: 1,
    param2: 2,
    param3: 3,
  };
  

• index.ts

  import * as Param1 from './parameter1';
  import * as Param2 from './parameter2';
  
  // 合并为统一对象
  export const Parameters = {
    ...Param1,
    ...Param2
  };
  
  // 使用示例
  console.log(Parameters.parameter1);
  console.log(Parameters.parameter2);
  

你之前的错误分析 #

1. 第一种尝试中，每个文件单独export { Parameters }会让每个文件成为独立模块，各自的Parameters是模块内的隔离命名空间，无法全局合并。
2. 第二种配置里，未先定义外层的Parameter命名空间，且未通过--outFile打包，浏览器无法找到全局的Parameter对象。
3. /// <reference path="..." />指令仅适用于非模块的全局脚本场景，且必须配合--outFile编译参数才能生效，在ES Modules环境下不起作用。

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