Node-Config v4.0.0 发布：支持 JSONC 和 MJS 配置文件

项目简介

Node-Config 是一个流行的 Node.js 配置管理库，它允许开发者以多种格式（如 JSON、YAML、TOML 等）组织应用程序配置，并支持环境变量覆盖、多环境配置等实用功能。该库特别适合需要复杂配置管理的大型 Node.js 应用。

主要更新内容

1. 新增文件格式支持

v4.0.0 版本最重要的改进是增加了对两种新配置文件格式的支持：

JSONC（JSON with Comments）支持：

• JSONC 是允许注释的标准 JSON 扩展格式
• 现在可以直接使用 .jsonc 扩展名的配置文件
• 注释在解析时会被自动忽略，不影响配置数据结构

MJS（ECMAScript 模块）支持：

• 支持使用 .mjs 扩展名的 ES 模块格式配置文件
• 需要 Node.js 24 或 20/22 的最新补丁版本
• 允许使用现代 JavaScript 语法编写配置
• 注意：与传统的 .js 配置文件不同，MJS 文件必须使用 ES 模块的 export 语法

2. 配置加载顺序调整

本次版本对 APP_INSTANCE 配置文件的加载顺序进行了调整，使其与其他文件集的加载顺序保持一致。这一变化虽然细微，但对于依赖特定加载顺序的应用可能产生影响。

3. 移除废弃功能

• 移除了未使用的 stripComments() 函数
• 完全移除了对 runtime.[ext] 文件的加载支持（该功能此前已被标记为废弃）

技术细节解析

代理(Proxy)改进

新版本对配置对象的 Proxy 处理进行了两项重要改进：

1. 绕过 RegExp 和 Date 对象的代理：

   • 避免对这些特殊对象进行不必要的代理包装
   • 提高了处理这些类型配置时的性能

2. 添加 get 陷阱：

   • 实现了更灵活的原型访问机制
   • 使配置对象的行为更加符合 JavaScript 对象的常规预期

异步处理优化

修复了异步和延迟处理中的过度递归问题，提高了在处理大型配置时的性能和稳定性。

环境变量处理改进

修复了 NODE_CONFIG_DIR 环境变量中包含空条目时的问题，使配置目录的处理更加健壮。

升级注意事项

1. Node.js 版本要求：

   • 如需使用 MJS 支持，需要 Node.js 24 或 20/22 的最新补丁版本

2. 向后兼容性：

   • 移除 runtime.[ext] 支持可能影响仍在使用此功能的旧项目
   • APP_INSTANCE 加载顺序变更可能影响依赖特定加载顺序的应用

3. 代码修改建议：

   • 检查项目中是否使用了已移除的 stripComments() 函数
   • 如果使用 runtime.[ext] 文件，需要迁移到其他配置方式

总结

Node-Config v4.0.0 通过添加对 JSONC 和 MJS 格式的支持，进一步丰富了配置文件的格式选择，使开发者能够根据项目需求选择最合适的配置方式。同时，通过移除废弃功能和优化内部实现，提高了库的稳定性和性能。对于新项目，建议直接采用此版本；对于现有项目，升级前应仔细评估变更影响，特别是涉及废弃功能的部分。