在TypeScript+React中实现单例：类与对象字面量该选哪个？

在TypeScript+React开发里，单例模式常用来实现全局工具类、状态管理或共享服务。你提到的对象字面量和类两种实现方式，核心都是保证全局唯一实例，但在封装性、灵活性等方面差异不小，下面详细拆解各自的优缺点及类实现的潜在问题：

一、两种实现的核心形态 #

对象字面量单例 #

这是最简洁的单例实现，本质是一个不可被重新赋值的对象引用，代码加载时直接初始化：

interface IExample {
    var_one: string;
    var_two: boolean;

    func_one: () => void;
    func_two: () => void;
}

const Example:IExample = {
    var_one: "",
    var_two: false,

    func_one() {
        return;
    },

    func_two() {
        return;
    }
}

类实现单例（饿汉式） #

通过静态属性存储实例，构造函数限制外部实例化，确保全局唯一。注意你的原代码里constructor是公开的，建议改为private让TypeScript编译时就阻止外部new操作，同时添加getInstance方法统一获取实例：

class ExampleClass
{
    private static _instance: ExampleClass = new ExampleClass();
    // 私有属性，外部无法直接访问
    private var_one: string = "";
    private var_two: boolean = false;

    // 设为private，禁止外部实例化
    private constructor() {
        if(ExampleClass._instance){
            throw new Error("Instance already created");
        }
        ExampleClass._instance = this;
    }

    // 统一的实例获取入口
    public static getInstance(): ExampleClass {
        return ExampleClass._instance;
    }

    func_one() {
        this.var_one = "modified";
        return;
    }

    func_two() {
        return;
    }
}

二、优缺点对比 #

对象字面量单例 #

优点：

• 极简直观：代码量少，一眼就能看懂是全局单例，无需额外逻辑
• 天生安全：const保证引用不会被替换，浏览器单线程环境下完全不存在多实例风险
• 类型友好：直接绑定接口，TypeScript的类型检查全覆盖，使用时无需额外断言
• 无额外开销：没有类实例化的过程，性能略优（虽差异极小）

缺点：

• 无真正私有状态：所有属性、方法都是公开的，外部可以直接修改var_one这类属性，无法封装内部逻辑
• 无法延迟加载：代码加载时就初始化，即使后续没用到也会占用内存
• 扩展性差：无法被继承，也没法模拟复杂的实例化流程
• 异步初始化困难：没有构造函数，难以在初始化时执行异步逻辑（比如请求接口初始化数据）

类实现单例 #

优点：

• 真正封装：可以用private修饰属性，确保内部状态不被外部随意修改，还能通过getter/setter控制访问权限
• 支持懒加载：可以改成在getInstance时才创建实例，避免不必要的内存占用：

  class ExampleClass
  {
      private static _instance: ExampleClass | null = null;
  
      private constructor() {}
  
      public static getInstance(): ExampleClass {
          if (!ExampleClass._instance) {
              ExampleClass._instance = new ExampleClass();
          }
          return ExampleClass._instance;
      }
  }
  

• 贴合OOP风格：如果项目以面向对象设计为主，类单例更符合整体代码规范
• 初始化灵活：构造函数里可以执行复杂的初始化逻辑，甚至结合异步操作（需调整为异步getInstance）
• 支持继承：可以作为父类被扩展（需注意继承后保持单例特性，避免破坏全局唯一性）

缺点：

• 实现繁琐：需要编写静态属性、构造函数校验、getInstance方法，代码量比对象字面量多
• 误用风险：如果没把constructor设为private，外部可能误调用new导致报错或多实例
• 测试复杂度高：全局静态属性的状态会在测试用例间共享，需要额外的重置逻辑清理状态
• Tree Shaking兼容性弱：类单例的静态属性可能被打包工具标记为不可移除，即使没被引用也会留在打包产物中

三、类实现的额外注意事项（React环境） #

在React项目中使用类单例时，要特别注意：

• 避免持有组件引用：单例的生命周期是全局的，如果持有组件的state、ref或DOM节点，组件卸载后可能导致内存泄漏
• 状态同步问题：如果单例存储的状态需要和React组件同步，可能需要结合状态管理库（如Redux、Zustand），否则容易出现视图不更新的问题

四、选择建议 #

如果你的场景满足以下任一条件，优先选类实现：

• 需要封装私有状态，禁止外部直接修改内部属性
• 需要延迟加载优化内存
• 项目采用OOP架构，希望代码风格统一
• 后续可能需要扩展单例的功能（如继承、异步初始化）

如果只是需要一个简单的全局工具对象，没有复杂的状态封装需求，对象字面量足够用，而且更简洁。

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