Node.js中exports与module.exports区别

发布于:2025-07-05 ⋅ 阅读:(15) ⋅ 点赞:(0)

在 Node.js 中,exports 和 module.exports 都是用于模块导出的对象,但它们在引用关系和使用场景上有重要区别:

� 核心区别总结

特性 exports module.exports
本质 module.exports 的引用 模块最终导出的真实对象
初始化关系 exports = module.exports (初始指向同一对象) 模块实际导出的对象
直接赋值后果 断开引用(导出失效) 正确覆盖导出内容
适用场景 添加多个属性/方法 导出任意类型(函数/类/对象等

🔍 详细解释

  1. 初始关系
    Node.js 在编译模块时会隐式执行:
var module = { exports: {} }; // 真实导出对象
var exports = module.exports; // 初始指向同一内存地址

此时 exports 是 module.exports 的快捷引用,两者指向同一个空对象 {}。

  1. 正确用法
    ✅ 添加属性(两者等效)

javascript
// 方式一:使用 exports

exports.name = 'Alice';
exports.sayHi = () => 'Hello!';

// 方式二:使用 module.exports

module.exports.name = 'Bob';
module.exports.sayHi = () => 'Hi!';

⚠️ 此时 exports 和 module.exports 仍指向同一对象,导出内容相同。

✅ 导出特殊类型(必须用 module.exports)

javascript

// 导出构造函数
module.exports = class Person { ... };

// 导出函数
module.exports = function() { ... };

// 导出原始值
module.exports = 'Hello World';
  1. 错误用法
    ❌ 直接给 exports 赋值(引用断裂)
exports = { name: 'Charlie' }; // 错误!断开与 module.exports 的链接

此时 exports 指向新对象,但模块实际导出的是原始的 module.exports(仍是空对象 {})。

🚨 关键注意事项

最终导出的是 module.exports
无论操作 exports 还是 module.exports,模块最终返回的是 module.exports 的值。

赋值优先级
若同时操作两者,最后执行的赋值决定导出结果:

exports.a = 1;         // 无效:被下一行覆盖
module.exports = { b: 2 }; // 最终导出 { b: 2 }

📌 最佳实践建议

场景 推荐方式
导出多个属性/方法 exports.xxx = …
导出单一功能(函数/类/对象) module.exports = …
避免混淆 统一使用 module.exports

🌰 代码示例

正确导出函数

// ✅ 正确
module.exports = () => console.log('Imported!');

// ❌ 错误(exports 无法导出函数)
exports = () => console.log('This will fail!');

混合使用案例

exports.name = 'Alice';  // 有效:添加属性
module.exports.age = 30; // 有效:添加属性

// 最终导出 { name: 'Alice', age: 30 }
exports.name = 'Bob';
module.exports = { age: 25 }; // 覆盖之前的所有导出
// 最终导出 { age: 25 } (name 被丢弃)

💡 总结
使用 exports 添加属性,用 module.exports 覆盖导出对象。
永远不要直接赋值 exports(exports = …)。
当需要导出非对象类型(函数、字符串等)时,必须使用 module.exports。
不确定时,统一使用 module.exports 可避免意外错误。
理解两者引用关系的本质,能有效避免模块导出时的常见陷阱!

■ exports返回的是模块函数
■ module.exports返回的是 模块对象本身