ES Modules 插件化架构核心是静态导入确定性、动态导入灵活性与显式导出可控性的结合:插件导出统一 install 函数,主应用通过 use 注册并调度生命周期,支持 import() 按需加载与沙箱约束。

用 ES Modules 实现插件化架构,关键不是“怎么导入”,而是**如何利用静态导入的确定性 + 动态导入的灵活性 + 显式导出的可控性**,构建一套可注册、可组合、可隔离的扩展机制。它不依赖运行时魔法,而靠结构设计和约定落地。
明确插件接口与模块职责边界
每个插件必须是一个独立的 ES 模块,且只暴露一个标准入口(如 install 函数),不自动执行任何逻辑:
- 插件模块导出统一函数:export function install(app, options = {}) { ... };不导出类、实例或副作用代码
- 主应用不直接 import 插件实现,而是通过配置或动态加载决定启用哪些插件
- 禁止插件模块内部 import 主应用源码(避免循环依赖),所有交互必须通过传入的 app 实例进行
- 插件之间不互相 import,保持正交——功能耦合由主应用协调,而非插件间通信
主应用提供插件注册与生命周期调度
主应用类(如 App)需内置 use 方法,并管理插件执行时机:
DMap GL地图JSAPI(dmapgl)开发指南。用于编写、审查、调试 DMap 地图 API 代码,涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- use(plugin, options) 接收插件模块(或其 install 函数),调用 plugin.install(this, options)
- 在构造函数或 init 阶段触发 beforeInit、afterInit 等钩子,让已注册插件有机会介入初始化流程
- 支持插件返回 teardown 函数,在应用销毁时统一调用,清理定时器、事件监听等资源
- 用 Set 或 Map 记录已注册插件标识(如 plugin.name),防止重复安装
用 dynamic import() 支持按需/远程插件加载
ES Modules 的 import() 表达式是实现真正插件热插拔的基础:
- 从配置读取插件路径列表,逐个 import() 加载:const plugin = await import('./plugins/logger.js')
- 配合 manifest.json 描述插件元信息(name、version、dependencies、entry),主应用校验后再加载
- 错误处理必须显式:catch 块中记录失败插件、跳过加载,不影响主流程
- 不推荐在模块顶层使用 import(),应封装在 use 或 loadPlugin 方法内,确保可控上下文
导出收敛 + 沙箱约束保障安全扩展
主应用向插件暴露的 API 必须精简、受控,不能是 this 或全局对象:
- 创建 context 对象,仅包含允许调用的方法(如 app.on、app.emit、app.config.get)
- 用 Proxy 封装 context,拦截对非法属性的访问(如禁止插件访问 document 或 fetch)
- 主应用的 index.js 只 re-export 核心类和公共类型,插件相关类型(Plugin, PluginOptions)单独导出供类型检查
- 插件模块不参与主包 tree-shaking,但可通过 rollup-plugin-dynamic-import-variables 等工具优化 chunk

















