CommonJS虽无二次包装语法，但可通过导入→封装→重新导出统一API、屏蔽差异、增强类型安全；常见于SDK统一、新旧包适配及错误处理收敛；需明确函数签名、错误格式、返回结构等封装目标，并注意module.exports正确用法。
CommonJS 本身不提供“二次包装”的语法机制，但你可以通过在自己的模块中 导入 → 封装 → 重新导出 的方式，对第三方模块做一层适配封装，从而统一 API 风格、屏蔽差异、增强类型安全或简化调用。这种做法在 Node.js 项目中很常见，尤其用于统一多个 SDK、适配旧版/新版包、或收敛错误处理逻辑。
明确封装目标再动手
先想清楚你要统一什么：
- 函数签名（比如把 callback 风格改成 Promise 风格）
- 错误格式（统一抛出 Error 实例，而非字符串或 null）
- 返回结构（始终返回
{ data, error }或Result<T>） - 配置入口（把分散的初始化参数收拢到一个 options 对象）
- 环境隔离（开发/测试/生产自动加载不同实例）
基础封装模式：导入 + 重构导出
以 popular-request（假设是一个回调风格 HTTP 库）为例，封装为 Promise 化、结构标准化的版本：
// lib/http-client.js
立即学习“Java免费学习笔记（深入）”；
const request = require('popular-request');
function httpRequest(options) { return new Promise((resolve, reject) => { request(options, (err, res, body) => { if (err) return reject(new Error(err.message || 'Network error')); resolve({ data: body, status: res.statusCode }); }); });}
module.exports = { httpRequest };
其他模块只需 const { httpRequest } = require('./lib/http-client')，不再直接依赖 popular-request，后续可无缝替换底层实现。
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
高级封装：代理式统一入口
当要统一封装多个第三方模块（如数据库 client、缓存 client、消息队列 client），可用单例 + 工厂模式集中管理：
// services/index.js
const Redis = require('redis');const pg = require('pg');const amqp = require('amqplib');
class ServiceFactory { static redis() { const client = Redis.createClient(); client.on('error', err => console.error('Redis error:', err)); return client; } static postgres() { return new pg.Pool({ /* config */ }); }}
module.exports = ServiceFactory;
业务层调用：const redis = require('./services').redis(); —— 所有初始化逻辑、错误监听、连接复用都在这一层收敛。
注意 exports 和 module.exports 的边界
封装时务必避免误写 exports = {...}，这会切断与 module.exports 的引用关系，导致模块导出为空对象：
- ✅ 正确：
exports.httpRequest = httpRequest;或module.exports = { httpRequest }; - ❌ 错误：
exports = { httpRequest };（此时外部require()得到的是空对象）
推荐统一使用 module.exports = {...}，语义清晰、不易出错。
