闭包在模块化重构中通过作用域隔离和引用保留实现封装，关键在于设计意图而非语法：用模块顶层作用域隐藏私有类与工具函数、导出对象时用闭包维持私有状态、避免exports重赋值破坏绑定、通过index.js收敛接口。
闭包在模块化重构中不是“加个函数就完事”，而是通过作用域隔离和引用保留，让外部既用得顺手，又碰不到底层细节。关键不在语法，而在设计意图——你希望用户依赖什么，而不是暴露了什么。
用模块顶层作用域封住类和工具函数
把真正不该被外部访问的类、辅助函数、状态变量，全部定义在模块文件的最外层函数作用域内（即模块全局作用域），但绝不挂到 module.exports 上。它们只对本模块内导出的函数可见，外部 require 后完全无法访问。
- ✅ 正确示例：
```js
const ConnectionPool = class { /* 私有连接池 */ };
const Logger = (msg) => console.debug('[DB]', msg);
module.exports = {
createClient(config) {
const pool = new ConnectionPool(config);
return {
query(sql) {
Logger(`Executing: ${sql}`);
return pool.execute(sql);
}
};
}
};
```
这里 ConnectionPool 和 Logger 对调用者彻底不可见。 - ❌ 错误做法：把类导出、或写成
exports.ConnectionPool = ConnectionPool，等于主动交出封装权。
导出对象时用闭包维持私有状态
当需要返回一个带状态的对象（比如配置管理器、计数器、缓存实例），不要直接暴露原始数据，而是返回一个由闭包生成的对象，其方法共享内部变量，但变量本身无法从外部读取或篡改。
- 例如统一配置模块：
```js
const defaults = { timeout: 5000, retries: 3 };
let config = { ...defaults };
module.exports = {
set(key, value) { config[key] = value; },
get(key) { return config[key]; },
reset() { config = { ...defaults }; }
};
```
虽然 config 是模块级变量，但外部无法绕过这三层方法直接操作它；即使有人用require('./config').config也拿不到——因为没导出。 - 更进一步可将 config 放进 IIFE 或工厂函数里，彻底隔绝顶层污染。
避免 exports 重赋值导致闭包失效
很多人用 exports = { ... } 替代 module.exports = { ... }，结果闭包里引用的私有变量还在，但外部 require() 却得到空对象——因为 exports 被重指向新对象，切断了与 module.exports 的默认绑定。
立即学习“Java免费学习笔记（深入）”；
- ⚠️ 错误：
exports = { createClient }; // 此时 module.exports 仍是 {} - ✅ 安全写法：
module.exports = { createClient };或逐步挂载：exports.createClient = createClient;（前提是不重赋值 exports）
配合 index.js 做接口收敛，屏蔽路径与实现演进
随着重构深入，内部可能拆出 lib/pool.js、lib/validator.js 等子模块。此时不要让用户 require('mylib/lib/pool')，而是在根目录 index.js 中统一导入并导出语义化接口：
- ```js
// index.js
const { createClient } = require('./lib/client');
const { validateConfig } = require('./lib/validator');
module.exports = {
createClient,
validateConfig,
VERSION: '2.1.0'
};
``` - 这样后续哪怕把
validator重写为 WebAssembly 模块，或合并进client，只要index.js导出不变，所有用户代码零改动。
