Node.js模块化实践：如何导出可复用函数与类优化代码结构

将可复用的函数和类组织并导出到单独的模块中，是提升代码可读性与可维护性的关键一步。通过模块化，你不仅能保持代码库的整洁，还能让其他开发者更轻松地理解和使用你的代码。

下面，我们通过对比两种不同的代码组织方式，来直观感受模块化带来的好处。

良好实践示例

在这个示例中，我们将相关的功能函数集中定义在一个独立的工具模块中。

首先，创建一个名为 mathUtils.js 的模块文件，用于存放数学相关的实用函数：

// mathUtils.js
// 从模块中导出可复用的函数
/**
 * Adds two numbers.
 * @param {number} a - The first number.
 * @param {number} b - The second number.
 * @returns {number} The sum of the two numbers.
 */
function add(a, b) {
  return a + b;
}

/**
 * Subtracts the second number from the first number.
 * @param {number} a - The first number.
 * @param {number} b - The second number.
 * @returns {number} The difference of the two numbers.
 */
function subtract(a, b) {
  return a - b;
}

module.exports = { add, subtract };

然后，在主文件 main.js 中，我们可以按需导入并使用这些函数：

// main.js
// 导入并使用可复用的函数
const { add, subtract } = require('./mathUtils');

console.log(add(5, 3)); // 输出：8
console.log(subtract(5, 3)); // 输出：2

这种做法的优势很明显：函数被定义在独立的模块（mathUtils.js）中，主文件（main.js）通过导入来使用它们。代码结构清晰，职责分离，无论是单独测试工具函数，还是未来扩展功能，都更加方便。

反面模式示例

现在，让我们看看一个不那么理想的实现方式，它将所有逻辑都堆砌在同一个文件里：

// main.js
// 在主文件中直接定义函数
function add(a, b) {
  return a + b;
}

function subtract(a, b) {
  return a - b;
}

console.log(add(5, 3)); // 输出：8
console.log(subtract(5, 3)); // 输出：2

在这个“糟糕”的示例中，add 和 subtract 函数直接定义在主文件里。当项目规模增长、函数数量增多时，这种写法会导致主文件迅速膨胀，逻辑混杂，极大地降低了代码的可读性和可维护性，也给调试和团队协作带来困难。

核心机制备忘录

实现上述模块化能力的基础是 Node.js 内置的 CommonJS 模块系统。它通过 module.exports 对象来导出模块内容，再通过 require() 函数来导入其他模块。这套机制帮助我们将复杂的应用程序分解为一个个高内聚、低耦合的可复用组件，是构建可维护性项目的基石。

掌握模块的导入导出，是每一位 Node.js 开发者必备的基本功。希望本文的对比能帮助你更深刻地理解其价值。如果你想深入学习更多 Node.js 的工程化实践，欢迎来 云栈社区 交流探讨。