TypeScript：如何替代Namespaces实现接口关联静态功能？

嘿，这个问题我之前重构代码的时候也纠结过！确实，TypeScript官方现在更推荐用ES模块的方式组织代码，namespaces已经是比较旧的写法了。针对你的Timestamp接口和相关静态方法需求，给你几个更优雅的替代方案：

方案1：接口+同名类的声明合并（最推荐） #

TypeScript支持声明合并特性，同名的接口和类可以合并在一起。我们可以用接口定义类型结构，用类来提供静态方法，完美替代原来namespace的用法：

// 定义Timestamp类型接口
export interface Timestamp {
  seconds: number | Long;
  nanos: number;
}

// 定义同名类，仅实现静态方法（不需要实例化）
export class Timestamp {
  static now(): Timestamp {
    // 这里写你的实现逻辑，比如：
    const currentTime = Date.now();
    return {
      seconds: Math.floor(currentTime / 1000),
      nanos: (currentTime % 1000) * 1000000
    };
  }

  // 还可以添加其他静态方法，比如从Date转换的方法
  static fromDate(date: Date): Timestamp {
    const time = date.getTime();
    return {
      seconds: Math.floor(time / 1000),
      nanos: (time % 1000) * 1000000
    };
  }
}

使用的时候和原来的namespace写法几乎一致，类型提示也完全正常：

// 用Timestamp作为类型
const myTimestamp: Timestamp = Timestamp.now();
// 调用静态方法
const fromDate = Timestamp.fromDate(new Date());

这种方式既符合现代TypeScript规范，又保留了你习惯的调用方式，TSLint也不会再报错。

方案2：分离接口和工具函数（纯函数风格） #

如果不想用类，也可以把接口和相关函数分开导出，这种方式更偏向函数式编程风格，代码清晰直观：

export interface Timestamp {
  seconds: number | Long;
  nanos: number;
}

// 单独导出相关工具函数
export function getTimestampNow(): Timestamp {
  const currentTime = Date.now();
  return {
    seconds: Math.floor(currentTime / 1000),
    nanos: (currentTime % 1000) * 1000000
  };
}

export function timestampFromDate(date: Date): Timestamp {
  const time = date.getTime();
  return {
    seconds: Math.floor(time / 1000),
    nanos: (time % 1000) * 1000000
  };
}

使用时直接导入需要的接口和函数：

import { Timestamp, getTimestampNow } from './timestamp';
const myTimestamp: Timestamp = getTimestampNow();

方案3：模块级工具对象（优化你的原有写法） #

如果你还是喜欢把相关方法聚合在一起，也可以优化你原来的对象写法，给它起一个更清晰的名字，避免和接口重名造成混淆：

export interface Timestamp {
  seconds: number | Long;
  nanos: number;
}

// 用工具对象聚合相关方法，命名更明确
export const TimestampHelpers = {
  now(): Timestamp {
    const currentTime = Date.now();
    return {
      seconds: Math.floor(currentTime / 1000),
      nanos: (currentTime % 1000) * 1000000
    };
  },

  fromDate(date: Date): Timestamp {
    const time = date.getTime();
    return {
      seconds: Math.floor(time / 1000),
      nanos: (time % 1000) * 1000000
    };
  }
};

使用时：

const myTimestamp: Timestamp = TimestampHelpers.now();

总结 #

个人最推荐方案1，它完美适配了你原来的使用习惯，同时符合TypeScript的现代最佳实践。方案2和3则适合不同的代码风格偏好，你可以根据自己的项目情况选择~

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