如何在共享外部模块中强制实现JavaScript单例模式

开发者阿泽

2026-5-22

这个场景我太熟了！明明把模块C写成了单例，结果因为A和B拉了不同版本的C，或者其中一个把C打包进去了，导致跑起来出现两个实例，各种奇怪的bug。下面分享几个实战中好用的解决方法：

1. 全局对象挂载（浏览器/Node.js通用）

核心思路是把单例实例挂载到全局环境里，不管模块C被加载多少次，都优先从全局拿实例，没有再创建。

比如模块C可以这么写：

// 模块C的实现
let instance;

// 定义单例的核心逻辑
function createSingletonInstance() {
  return {
    count: 0,
    increment() {
      this.count++;
      console.log(`当前计数：${this.count}`);
    }
  };
}

// 根据环境挂载到全局
if (typeof window !== 'undefined') {
  // 浏览器环境
  if (!window.__MySingletonC__) {
    window.__MySingletonC__ = createSingletonInstance();
  }
  instance = window.__MySingletonC__;
} else if (typeof global !== 'undefined') {
  // Node.js环境
  if (!global.__MySingletonC__) {
    global.__MySingletonC__ = createSingletonInstance();
  }
  instance = global.__MySingletonC__;
}

module.exports = instance;

优缺点：实现简单，零额外依赖；但会污染全局命名空间，适合小型项目或可控的环境，记得给全局变量加个独特的前缀避免冲突。

2. 锁定依赖解析路径（从根源解决）

这个方法是从依赖管理层面下手，确保所有模块都加载同一个版本/路径的C，自然单例就能正常工作。

Node.js环境（npm/yarn/pnpm）

在项目根目录的package.json里强制指定C的版本：

{
  "name": "your-project",
  // npm/yarn用resolutions
  "resolutions": {
    "c": "^1.2.0" // 强制所有依赖的c都用这个版本
  },
  // pnpm用overrides
  "pnpm": {
    "overrides": {
      "c": "^1.2.0"
    }
  }
}

Webpack/Rollup等构建工具

用别名（alias）把所有对C的引用指向同一个文件：

// webpack.config.js
const path = require('path');

module.exports = {
  // ...其他配置
  resolve: {
    alias: {
      'c': path.resolve(__dirname, 'node_modules/c') // 强制指向项目根目录的c
    }
  }
};

优缺点：从根源解决依赖重复的问题，是大型项目的首选方案；需要修改项目配置，对第三方依赖的嵌套版本也能生效。

3. 自定义单例注册中心（灵活可控）

创建一个专门的注册中心模块，所有需要单例的模块都通过它来获取实例，相当于自己实现一个全局缓存。

先写注册中心singleton-registry.js：

const singletonMap = new Map();

/**
 * 获取或创建单例
 * @param {string} key 单例的唯一标识
 * @param {Function} createFn 创建实例的函数
 * @returns {any} 单例实例
 */
function getSingleton(key, createFn) {
  if (!singletonMap.has(key)) {
    const instance = createFn();
    singletonMap.set(key, instance);
  }
  return singletonMap.get(key);
}

module.exports = { getSingleton };

然后模块C里使用这个注册中心：

// 模块C
const { getSingleton } = require('./singleton-registry');

const cInstance = getSingleton('unique-key-for-module-c', () => {
  // 这里写C的单例逻辑
  return {
    someStaticMethod() {
      return '我是唯一的实例方法';
    }
  };
});

module.exports = cInstance;

优缺点：不直接污染全局，通过专门的模块管理单例，灵活性高；需要额外维护注册中心模块，适合复杂的多模块场景。

4. Node.js专属：手动管理require缓存

Node.js的require.cache会缓存已加载的模块，我们可以利用这个特性强制模块C只加载一次：

// 模块C
const modulePath = require.resolve('./c'); // 获取当前模块的绝对路径

// 如果缓存里已有，直接导出缓存的实例
if (require.cache[modulePath]) {
  module.exports = require.cache[modulePath].exports;
} else {
  // 创建单例实例
  const instance = {
    state: 'init'
  };
  module.exports = instance;
  // 手动把实例存入缓存
  require.cache[modulePath] = { exports: instance };
}

注意：这个方法要确保所有模块引入C时用的是相同的路径（比如都用绝对路径，或者通过别名统一），否则不同路径会生成不同的缓存key，还是会出现多实例。

总结一下：优先推荐锁定依赖解析路径的方法，从根源解决问题；如果是浏览器环境或无法修改依赖配置，全局挂载或注册中心是不错的选择；Node.js里可以结合require.cache做补充。

内容的提问来源于stack exchange，提问作者S.Kraus

如何在共享外部模块中强制实现JavaScript单例模式

1. 全局对象挂载（浏览器/Node.js通用） #

2. 锁定依赖解析路径（从根源解决） #

Node.js环境（npm/yarn/pnpm） #

Webpack/Rollup等构建工具 #

3. 自定义单例注册中心（灵活可控） #