如何在TypeScript文件中保留自动补全并避免使用namespace

你完全不需要使用namespace，保持原有的ES模块导出方式就是最优解，具体说明如下：

原方案的合理性 #

你的原始代码已经是标准的ES模块导出写法：

// file: myFunctions.ts
// Function 1
export function add(a: number, b: number): number {
    return a + b;
}

// Function 2
export function subtract(a: number, b: number): number {
    return a - b;
}

// Function 3
export function multiply(a: number, b: number): number {
    return a * b;
}

其他文件通过import * as CalcFunctions from './myFunctions'导入后，CalcFunctions本质就是一个聚合了所有导出函数的对象，和你想用namespace实现的效果完全一致：

• 调用方式不变：CalcFunctions.add(1,2)、CalcFunctions.subtract(3,1)
• TypeScript自动补全完全支持，输入CalcFunctions.就能触发所有函数的提示
• 完全符合ESLintno-namespace规则的要求，不会触发代码告警

为什么不需要namespace？ #

TypeScript的namespace更多是为兼容早期非模块化的JavaScript场景设计的。在现代ES模块体系下，单个文件本身就是一个天然的命名空间：

• 模块内的成员默认被隔离，不会污染全局作用域
• import * as语法天然实现了将模块导出成员聚合为一个对象的效果，和namespace的使用体验完全对齐

可选优化（不影响现有导入逻辑） #

如果想让代码结构更紧凑，也可以用对象聚合导出，同时保留原有导入兼容性：

// myFunctions.ts
export const CalcFunctions = {
  add(a: number, b: number): number {
    return a + b;
  },
  subtract(a: number, b: number): number {
    return a - b;
  },
  multiply(a: number, b: number): number {
    return a * b;
  }
};

// 同时保留单独导出，兼容原有导入和按需导入
export const { add, subtract, multiply } = CalcFunctions;

这种写法同样支持import * as CalcFunctions from './myFunctions'，自动补全正常，还能额外支持按需导入import { add } from './myFunctions'。

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