JavaScript防范全局污染的核心是源头控制作用域，只暴露唯一顶层标识符（如window.AcmeSDK），用IIFE封装私有变量，并优先采用ES Module机制杜绝污染。
JavaScript 中全局变量本身不需“配置”，关键在于不主动创建，更不随意暴露。防范命名空间污染的核心不是修补已有的全局变量，而是从源头控制作用域——让变量、函数、类只在真正需要的地方可见。
只暴露一个顶层标识符
如果必须向全局挂载内容（如老项目兼容、微前端子应用、SDK入口），就严格限定为唯一对象名，比如 window.AcmeSDK 或 window.MyApp。所有功能都作为其属性存在：
AcmeSDK.auth.login()AcmeSDK.utils.formatDate(new Date())AcmeSDK.config = { apiUrl: '/v1' }
避免写 function login() {} 或 var utils = {...} 这类直接挂到 window 上的代码。整个项目只新增一个全局变量，污染面就被收束到最小。
用 IIFE 封装初始化逻辑
即使要暴露顶层对象，内部实现也应隔离。立即执行函数表达式（IIFE）能创建私有作用域，防止缓存、计数器、临时变量泄露：
立即学习“Java免费学习笔记（深入）”；
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
(function (global) {
if (!global.AcmeSDK) {
global.AcmeSDK = {};
}
const privateCache = new Map();
const DEFAULT_TIMEOUT = 5000;
global.AcmeSDK.auth = {
login(user) {
privateCache.set('lastUser', user);
return fetch('/login', { timeout: DEFAULT_TIMEOUT });
}
};
})(typeof window !== 'undefined' ? window : global);
这样，privateCache 和 DEFAULT_TIMEOUT 完全不可见，外部只能通过 AcmeSDK.auth.login 访问公开接口。
优先走 ES Module 路线
现代项目中，不要靠命名空间“缓解”污染，而要靠模块机制“杜绝”污染：
- 用
export明确导出所需函数或类，不导出的默认不可见 - 用
import按需引入，依赖关系清晰可查 - 打包工具（Vite/Webpack）会自动做作用域提升和 tree-shaking，不会把未使用的代码塞进全局
哪怕只是单页小工具，也建议用 <script type="module"></script> 启动，天然规避全局污染问题。
老项目补救与协作规范
接手维护无模块化的老系统时，重点不是重写，而是建立防御习惯：
- 新增逻辑一律包裹在 IIFE 内，不写裸变量或裸函数
- 若需跨脚本通信，统一走
MyApp.eventBus或自定义事件，而非直接读写window.xxx - 给全局变量加前缀，如
_acme_config、$acme_utils，降低被覆盖概率 - 启用
"use strict"，让隐式全局（如漏写var）直接报错，不静默失败
命名空间是过渡手段，模块化才是正解。它不复杂但容易忽略。
