CommonJS模块天然具备单例语义，因require缓存机制确保同一模块只初始化一次并返回相同module.exports引用，无需额外同步；关键在于顶层导出已初始化实例且避免非幂等副作用。
JavaScript 中 CommonJS 模块本身是线程安全的单例——每个模块文件在 Node.js 进程内只会被 require 一次，后续调用返回缓存的 module.exports，天然具备单例语义。因此，“编写线程安全的单例模式导出模块”在 CommonJS 环境下并不需要额外加锁或同步机制，关键在于避免在模块顶层执行非幂等初始化逻辑（如重复创建共享资源），并确保导出对象状态可被安全复用。
利用模块缓存实现自然单例
Node.js 的 require() 会将模块路径映射到已加载的 module.exports 对象，同一进程内多次 require('./mySingleton') 返回的是同一个对象引用：
- 模块代码只执行一次（首次
require时）； -
module.exports被缓存，后续导入直接返回该引用； - 无需
class或getInstance()，直接导出实例即可。
导出已初始化的实例（推荐写法）
把单例实例作为模块顶层变量创建并导出，是最简洁、最符合 CommonJS 设计的方式：
// logger.js
const winston = require('winston');
// 实例在模块加载时创建一次
const logger = winston.createLogger({
level: 'info',
transports: [new winston.transports.Console()]
});
// 直接导出实例（不是类或工厂函数）
module.exports = logger;
所有 require('./logger') 都拿到同一个 logger 实例，且初始化仅发生一次。
Comprehensive Three.js 3D graphics reference
下载
详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
立即学习“Java免费学习笔记（深入）”；
避免在模块顶层做非幂等操作
如果初始化逻辑涉及副作用（如启动定时器、监听事件、连接数据库），需确保它只运行一次，且不会因多次导入而重复触发：
- 不要在
module.exports中放工厂函数（除非明确需要多实例）； - 避免在模块顶层调用可能重复注册的 API（如
process.on('uncaughtException', ...)）； - 若必须动态初始化，可用私有标志位控制（但通常没必要）：
// db.js
let instance = null;
const init = () => {
if (instance) return instance;
instance = new DatabaseConnection();
instance.connect(); // 只连一次
return instance;
};
module.exports = { getInstance: () => init() };
不过这种写法反而掩盖了 CommonJS 的单例优势，不如直接导出实例清晰。
注意：Node.js 单进程模型下的“线程安全”
CommonJS 模块运行在单个 V8 实例中，Node.js 默认无多线程（Worker Threads 是显式启用的独立上下文）。所谓“线程安全”在标准 CommonJS 场景中实际指：
- 模块级变量不会被并发修改（因为 JS 是单线程执行）；
- 导出对象若被多个模块共享，其内部状态仍需业务层保证一致性（例如：多个地方调用
logger.addTransport()是安全的，但并发修改自定义属性需自行协调）； - Worker Threads 中每个线程有独立模块缓存，此时“单例”只在各自线程内成立。
