JavaScript作用域隔离是保障微应用状态独立最基础有效的手段,通过词法作用域在代码执行前划定变量边界,结合IIFE、闭包和ES Module实现私有状态封装与跨应用隔离。

JavaScript 作用域隔离是保障微应用状态独立最基础也最有效的手段之一。它不依赖框架或运行时沙箱,而是利用语言原生的词法作用域规则,在代码执行前就划定变量可见边界,从根本上防止状态泄露和冲突。
用函数作用域封装子应用逻辑
每个微应用入口应包裹在独立的函数中,所有内部变量、函数、状态都声明在该函数内,不暴露到全局。这样即使多个子应用同时加载,它们的 var/let/const 声明互不影响。
- 推荐使用 IIFE(立即调用函数表达式),显式控制作用域起点与终点
- 避免顶层裸变量声明,如
count = 0或function init() {...}直接写在 script 标签里 - 可传入
window或globalThis作为参数,明确依赖项,增强可测试性
用闭包实现私有状态与受控访问
闭包让内部变量在函数执行结束后仍被引用保持存活,同时对外不可直接访问——这是构建模块化状态管理的核心机制。
将一个或多个 UI 原型图、线框图、产品截图或设计稿转换为标准化、可直接交付的 PRD 风格文档,供产品、设计、前端和测试共同使用。适用于 Codex 需要分析 PC 网页、桌面端、移动端、响应式页面、独立弹窗、表单、表格、看板、数据大屏或多页面流程截图,还原页面结构与交互,强制套用固定文档模板,抽取跨页面共享规则,或把一组原型沉淀为单页规范文档加整体业务流程文档的场景。不适用于纯视觉审美点评、代码实现、接口设计、埋点方案、竞品分析或无 UI 输入的业务需求创作。
- 将状态(如用户信息、配置、计数器)定义在外部函数内,只通过返回对象暴露有限方法
- 避免返回原始数据引用,防止外部篡改;必要时用
Object.freeze或 getter 封装 - 子应用间不共享闭包实例,每个应用启动时创建自己的闭包上下文
配合模块系统强化边界
ES Module 天然具备顶层块级作用域,比 IIFE 更现代、更易维护,是当前推荐的默认方式。
立即学习“Java免费学习笔记(深入)”;
- 每个子应用以
export default暴露统一生命周期接口(bootstrap/mount/unmount),不导出内部状态变量 - 状态管理库(如 Zustand、Jotai)应在子应用内部初始化 store 实例,禁止跨应用复用同一 store
- 避免在模块顶层直接操作
window.xxx,所有副作用应收敛在生命周期钩子中
注意作用域与沙箱的协作关系
作用域隔离解决的是“代码编写时”的污染问题,而 qiankun 等框架的 JavaScript 沙箱解决的是“运行时”的全局写入隔离。二者不是替代,而是叠加。
- 即使启用了 Proxy 沙箱,若子应用在顶层写了
var api = new Api(),该变量仍会进入沙箱本地 window,但不会污染主应用 —— 这是沙箱的功劳 - 但如果子应用用
let token = 'xxx'声明在 IIFE 内,这个 token 根本不会出现在任何 window 上 —— 这是作用域的功劳 - 真正健壮的微应用,应同时做到:编写时靠作用域约束 + 运行时靠沙箱兜底

















