Node.js module.exports 解析：开发者完全指南 🚀

当我在项目中阅读某个some.config.js文件时，遇到了这行代码：

1

module.exports = { ... };

乍看之下很普通。但我问自己： 👉 module.exports在Node.js中到底是如何工作的？ 这个问题让我深入研究了Node的模块系统——从文件如何被包装，到require()的工作原理，以及exports与module.exports的区别。

以下是我学到的内容（也是每个JavaScript/Node开发者应该知道的）👇

🔹 什么是Node.js中的module.exports？💡

在Node.js中，每个文件都被视为一个模块。 当Node加载文件时，它不会直接运行代码，而是像这样包装你的代码：

1
2
3

(function (exports, require, module, __filename, __dirname) {
  // 你的文件内容
});

这个包装器让每个文件都能访问：

• exports
• require
• module
• __filename
• __dirname

这就是为什么你可以在文件中的任何地方使用module.exports而无需显式导入它。

🔹 exports与module.exports的关系🔄

在每个模块的开头，Node会执行：

1

exports = module.exports = {};

这意味着：

• exports只是module.exports的一个引用
• 默认情况下，两者都指向同一个对象
• 你添加到任意一个（不重新赋值）的内容都会被导出

✅ 示例：

1
2

exports.a = 10;          // 有效
module.exports.b = 20;   // 有效

结果：

1

{ a: 10, b: 20 }

🔹 常见错误⚠️

如果你重新赋值exports，就会破坏链接：

1
2
3
4

// ❌ 不会工作
exports = function () {
  console.log("Hello");
};

现在exports指向一个新函数，但module.exports仍然是{}。 所以什么都不会被导出。

✅ 正确方式：

1
2
3

module.exports = function () {
  console.log("Hello");
};

🔹 require()如何工作？🔍

当你写：

1

const myModule = require("./myModule");

以下是幕后的流程：

1. Node解析文件路径（./myModule.js）
2. 检查模块缓存（模块在运行时只加载一次）
3. 在函数包装器中包装并执行文件
4. 返回module.exports

💡 这就是为什么require()总是给你module.exports——而不是exports。

🔹 示例：在实践中使用module.exports📝

1
2
3
4
5
6
7

// user.js
module.exports = {
  name: "Yogesh",
  greet() {
    console.log(`Hello, ${this.name}`);
  }
};

1
2
3
4
5

// app.js
const user = require("./user");

console.log(user.name); // Yogesh
user.greet();           // Hello, Yogesh

🔹 CommonJS vs ES模块（CJS vs ESM）⚡

现代Node.js同时支持CommonJS（CJS）和ES模块（ESM）。

✅ CommonJS（Node中的默认）

1
2
3
4
5
6
7
8

// math.js
module.exports = {
  add: (a, b) => a + b
};

// app.js
const math = require("./math");
console.log(math.add(2, 3));

✅ ES模块（现代JS标准）

1
2
3
4
5
6
7
8

// math.mjs
export function add(a, b) {
  return a + b;
}

// app.mjs
import { add } from "./math.mjs";
console.log(add(2, 3));

🔑 主要区别：

• 语法 → module.exports vs export / import
• 加载 → CommonJS是同步的；ES模块是异步的
• 导出 → CommonJS通常导出单个对象；ESM支持多个命名导出
• 未来兼容性 → ESM是官方的JavaScript标准，更适合现代应用

🔹 最佳实践✅

• 使用exports.x = …来添加多个导出
• 当导出一个主要东西（函数、类或对象）时使用module.exports = …
• 在支持的新项目中优先使用ES模块（import/export）

✨ 结论

some.config.js中那小小的module.exports行结果成为了深入了解Node.js内部机制的门户。

看起来简单的——

1

module.exports = { ... };

——背后是一个强大的模块系统，它：

• 在函数中包装文件
• 链接exports和module.exports
• 通过require()只返回module.exports
• 支持CommonJS和ES模块

下次你使用module.exports时，请记住： 它不仅仅是样板代码——它是Node.js管理模块的核心。

✍️ 作者：Yogesh Bamanier 🔗 LinkedIn