TypeScript使用node-config deferConfig经tsc编译后报Cannot read property错误

运行行为不一致的原因 #

ts-node与tsc编译后运行的差异本质是ESM和CommonJS模块导出规范的兼容问题：

• ts-node默认内置了模块导出兼容逻辑，开启了esModuleInterop和allowSyntheticDefaultImports编译选项，加载export default导出的配置文件时，会自动提取default属性下的真实配置对象传递给node-config，因此deferConfig回调中的this指向的是预期的配置根对象，运行正常。
• tsc编译为CommonJS模块格式时，export default {配置内容}会被编译为module.exports.default = {配置内容}，node-config加载配置时默认直接读取module.exports的完整值，导致拿到的配置多了一层default嵌套，deferConfig回调的this指向包含default属性的外层对象，访问this.service自然就返回undefined触发报错。

是否应该改用export = #

如果项目最终编译为CommonJS格式运行，可以放心改用export =导出配置：

• export =是TypeScript为CommonJS环境提供的原生导出语法，会直接将导出内容赋值给module.exports，不会产生额外的default嵌套，ts-node和编译后的运行效果完全一致，没有兼容问题。
• node-config官方文档给出的export default示例是针对纯JavaScript的ESM运行环境，在TypeScript编译到CommonJS的场景下使用export =属于合理的场景适配，不会影响配置的功能逻辑。
  如果需要严格遵循官方示例使用export default，可以调整tsconfig开启esModuleInterop的同时，自定义node-config的配置加载逻辑提取default属性值，但实现成本远高于直接使用export =，无特殊需求优先选择export =即可。

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