如何通过exports控制API变量暴露范围并隐藏底层实现类细节-java教程-PHP中文网

Node.js模块应通过module.exports精确导出API，避免exports重赋值；优先导出工厂函数、单例或命名空间，用闭包隐藏私有类，并通过index.js统一暴露稳定接口。

如何通过exports控制api变量暴露范围并隐藏底层实现类细节

在 Node.js 模块系统中，exports（或 module.exports）是控制模块对外暴露接口的唯一出口。它不只决定“哪些变量能被 require”，更关键的是——**通过精心设计 exports 结构，你可以完全隐藏内部类、工具函数、中间状态等实现细节，只暴露稳定、语义清晰的 API**。

用 module.exports 替代 exports 赋值，避免引用丢失

exports 本质是 module.exports 的快捷引用，但一旦你对 exports 重新赋值（比如 exports = {...}），就会切断这个引用，导致外部 require 得到空对象。要精确控制暴露内容，必须统一使用 module.exports：

✅ 正确：直接赋值 module.exports = { init, createClient }
❌ 错误：exports = { init, createClient }（此时 require() 返回 {}）
⚠️ 可用但易错：exports.init = init + exports.createClient = createClient（仅适用于逐步挂载）

只暴露构造函数或工厂方法，不导出类本身

如果你有一个核心类 DatabaseConnection，不要直接 module.exports = DatabaseConnection。这会让使用者依赖具体类名、继承结构甚至私有属性命名，破坏封装性。应提供语义化入口：

导出工厂函数：module.exports = { createConnection: (config) => new DatabaseConnection(config) }
导出单例实例（如配置中心）：module.exports = new ConfigManager()（内部已封装初始化逻辑）
导出命名空间对象，含方法和常量：module.exports = { Client: { connect(), disconnect() }, STATUS: { READY, ERROR } }

用闭包隔离私有实现，禁止外部访问底层类

将类定义放在模块顶层作用域内，但不将其挂到 module.exports 上。借助函数作用域，让导出的方法能访问这些“私有类”，而外部无法 require 或 new 它们：

示例：

const ConnectionPool = class { /* 内部连接池实现 */ };
const QueryExecutor = class { /* 内部执行器 */ };
module.exports = {
  createClient(config) {
    const pool = new ConnectionPool(config);
    return { execute: (sql) => new QueryExecutor(pool).run(sql) };
  }
};

这里 ConnectionPool 和 QueryExecutor 在模块外不可见，用户只能通过 createClient 获取抽象后的客户端对象。