exports 是 module.exports 的引用别名，直接赋值 exports 会断开关联导致导出为空；正确方式包括逐个挂载、覆盖 module.exports 或导出单个函数/类，并需避免混用 ES6 与 CommonJS 模块。

exports 是 Node.js 模块系统中用于向外暴露变量、函数或对象的关键机制，它本质是 module.exports 的一个引用别名。实战中若误用（如直接赋值 exports = {...}），会导致模块导出为空，这是最常见也最容易踩的坑。

理解 exports 与 module.exports 的关系

在每个 CommonJS 模块中，Node.js 默认提供两个对象：

• exports 是 module.exports 的初始引用（浅拷贝指向同一对象）
• module.exports 才是真正决定模块对外输出内容的“权威出口”
• 一旦对 exports 重新赋值（如 exports = function() {...}），它就脱离了与 module.exports 的关联，后续 require 将得不到预期结果

正确暴露核心包变量的三种常用方式

假设你正在开发一个工具包 utils，希望对外暴露 formatDate、deepClone 和常量 MAX_RETRY：

• 方式一：逐个挂载到 exports（推荐初学者）
  

  exports.formatDate = function(date) { ... };<br>
    exports.deepClone = function(obj) { ... };<br>
    exports.MAX_RETRY = 3;

• 方式二：一次性覆盖 module.exports（更清晰、更常用）
  

  module.exports = {<br>
      formatDate: function(date) { ... },<br>
      deepClone: function(obj) { ... },<br>
      MAX_RETRY: 3<br>
    };

• 方式三：导出单个构造函数或类（适合封装为实例化对象）
  

  function Utils() {}<br>
    Utils.prototype.log = function(msg) { console.log('[Utils]', msg) };<br>
    module.exports = Utils;

实现模块间公共接口访问的典型协作逻辑

以「用户服务」依赖「数据库连接」为例，展示如何通过 exports 建立稳定接口契约：

• 在 db.js 中统一暴露连接方法：
  

  const pool = createPool(...);<br>
    exports.query = (sql, params) => pool.execute(sql, params);<br>
    exports.close = () => pool.end();

• 在 user-service.js 中按需导入并使用：
  

  const db = require('./db');<br>
    exports.getUserById = async (id) => {<br>
      const [rows] = await db.query('SELECT * FROM users WHERE id = ?', [id]);<br>
      return rows[0];<br>
    };

• 主应用只需消费最终业务接口：
  

  const userService = require('./user-service');<br>
    userService.getUserById(123).then(console.log);

避免常见陷阱的实用建议

写错 exports 往往导致 “Cannot destructure property... of undefined” 类错误，排查时重点关注：

• 禁止写 exports = { a: 1 } —— 这会切断引用，应改用 module.exports = { a: 1 }
• 若同时使用 exports.xxx = ... 和 module.exports = ...，后者会完全覆盖前者，优先级更高
• ES6 模块（import/export）与 CommonJS（require/exports）不互通；混用时需通过 package.json 的 "type": "module" 明确标识，否则可能报错
• 调试技巧：在模块末尾加 console.log('exports:', exports, 'module.exports:', module.exports) 快速验证导出内容是否一致