Node Cache Manager 6.0.0 版本中 CommonJS 支持问题解析

Node Cache Manager 是一个流行的 Node.js 缓存管理库，它提供了统一的接口来操作多种缓存存储后端。在最新的 6.0.0 版本中，开发者发现了一个关于 CommonJS 模块系统支持的重要变更。

问题背景

在 Node.js 生态系统中，CommonJS 和 ESM (ECMAScript Modules) 是两种主要的模块系统。长期以来，CommonJS 一直是 Node.js 的默认模块系统，但随着 JavaScript 语言的发展，ESM 正逐渐成为未来的标准。

Node Cache Manager 6.0.0 版本发布后，一些开发者发现当尝试使用 CommonJS 的 require() 语法导入库时，会遇到模块系统不兼容的错误。具体表现为尝试导入 CacheableMemory 类时会抛出 ERR_REQUIRE_ESM 错误。

技术原因分析

这个问题的根源在于 Node Cache Manager 6.0.0 依赖的底层库 hookified 已经完全转向了 ESM 模块系统。当 Node Cache Manager 的 CommonJS 版本尝试通过 require() 加载 hookified 时，由于后者是纯 ESM 模块，Node.js 的模块系统会阻止这种混合使用方式。

这种模块系统的不兼容性在 Node.js 生态系统中并不罕见，特别是在库逐步从 CommonJS 迁移到 ESM 的过程中。Node.js 官方文档明确指出，不能直接通过 require() 加载 ESM 模块，必须使用动态 import() 语法。

解决方案

项目维护者迅速响应了这个问题，并在 cacheable@1.3.0 版本中提供了修复。修复方案主要是确保在 CommonJS 环境下也能正确加载依赖的 ESM 模块。

不过，维护者也明确表示，虽然目前仍会尽量保持对 CommonJS 的支持，但从长远来看，全面转向 ESM 是大势所趋。这是因为：

1. ESM 是 JavaScript 的官方标准模块系统
2. ESM 支持静态分析，有利于 tree-shaking 等优化
3. 浏览器原生支持 ESM
4. ESM 具有更好的异步加载特性

开发者建议

对于仍在使用 CommonJS 的开发者，建议：

1. 立即升级到 cacheable@1.3.0 或更高版本
2. 开始规划向 ESM 的迁移
3. 如果必须使用 CommonJS，确保所有依赖链都兼容 CommonJS

对于新项目，强烈建议直接使用 ESM 模块系统，以避免未来可能出现的兼容性问题。可以通过在 package.json 中设置 "type": "module" 来启用 ESM 支持。

总结

Node Cache Manager 6.0.0 版本的这次变更反映了 Node.js 生态系统中模块系统的演进趋势。虽然短期内维护者提供了对 CommonJS 的兼容支持，但从长远来看，全面拥抱 ESM 是不可避免的技术方向。开发者应该理解这种变化背后的技术原因，并做好相应的技术升级准备。