闭包模块模式通过IIFE或工厂函数封装SDK，隔离私有状态并暴露可控接口：IIFE适用于单例场景（如日志上报），工厂函数支持多实例（如多租户推送），内置防重入、懒加载、参数校验与数据保护，且依赖可注入、环境解耦、支持销毁清理。
用闭包实现模块模式来封装第三方 SDK，核心是把 SDK 的初始化、状态管理、敏感逻辑和私有工具函数全部收进一个封闭作用域，只暴露干净、可控的公共接口。这种方式不依赖现代语法（如 # 私有字段或 ES 模块），兼容性好，且天然隔离实例状态，特别适合 SDK 封装场景。
用 IIFE 创建单例 SDK 模块
适用于全局唯一、轻量级的 SDK 封装（比如日志上报、设备信息采集等）：
- 把原始 SDK 的初始化、配置项、内部 token 或 client 实例声明在 IIFE 内部，外部无法直接访问
- 返回对象中只包含业务需要的方法，如
init()、trackEvent()、setConfig() - 可内置防重入、懒加载、错误兜底等逻辑，调用方无感知
示例：
const AnalyticsSDK = (function() {let client = null;
let enabled = false;
const init = (options) => {
if (client || !options.appId) return false;
client = new ThirdPartyAnalytics(options);
enabled = true;
return true;
};
return { init, trackEvent: (name, props) => enabled && client?.track(name, props) };
})();
用工厂函数支持多实例 SDK
当 SDK 需要按业务线、租户或环境创建多个独立实例时（如多个支付通道、不同账号的推送服务），必须避免共享私有状态：
- 每个工厂调用生成新的闭包环境，私有变量（如 session、缓存、计数器）完全隔离
- 可传入差异化配置，如 API 地址、密钥、超时时间，各实例互不影响
- 返回的实例对象方法仍能安全访问其专属私有数据
示例：
function createPushSDK(config) {const { appId, secret, endpoint } = config;
let token = null;
const fetchToken = () => {/* 调用 auth 接口获取 token */};
return {
send: async (msg) => {
if (!token) await fetchToken();
return fetch(endpoint, { headers: { Authorization: token }, body: msg });
},
};
}
结合私有工具函数与防御性封装
模块内可定义仅自身调用的辅助函数，提升内聚性，同时防止外部误用或绕过校验：
- 例如对传入参数做类型检查、签名计算、敏感字段过滤，统一在私有函数中处理
- 返回的公有方法只负责流程调度，不暴露底层细节
- 若需返回不可变数据（如用户信息），可返回深拷贝或只读代理，避免外部篡改影响内部状态
示例：
const AuthSDK = (function() {let userInfo = null;
const isValidUser = (u) => u?.id && typeof u.id === 'string';
const sanitize = (u) => ({ id: u.id, name: u.name }); // 过滤敏感字段
return {
setUser: (u) => { if (isValidUser(u)) userInfo = sanitize(u); },
getUser: () => userInfo ? { ...userInfo } : null, // 返回副本
};
})();
与宿主环境解耦的关键设计点
真正强封装的 SDK 不该假设运行环境，也不该污染全局：
- 所有依赖（如
fetch、localStorage）通过参数注入或检测后缓存，便于测试和替换 - 避免直接操作 DOM 或全局对象；如需回调，统一通过配置的
onError、onReady等函数通知 - 提供
destroy()方法清理定时器、事件监听、内存引用，防止内存泄漏
