
defer 无法保证非模块脚本在模块执行完毕后才运行,因模块加载与普通脚本的执行时序独立;需改用 load 事件监听或动态 import() 实现可靠调用。
`defer` 无法保证非模块脚本在模块执行完毕后才运行,因模块加载与普通脚本的执行时序独立;需改用 `load` 事件监听或动态 `import()` 实现可靠调用。
在现代 Web 开发中,混合使用 ES 模块(.mjs)与传统 <script></script> 脚本时,常误以为 defer 属性能统一协调执行顺序。但事实是:模块脚本(type="module")默认延迟执行且具有独立的解析/执行时序,而普通脚本即使带 defer,其执行时机仍早于模块内 window 属性赋值完成的时刻——这正是 ReferenceError: module1_function is not defined 的根本原因。
✅ 正确方案一:监听 window.load 事件(最轻量、兼容性好)
load 事件确保整个页面(含所有资源、模块脚本)完全加载并执行完毕后再触发回调,是最直接可靠的全局函数调用时机:
<script defer type="module" src="./js/module1.mjs"></script><script>
window.addEventListener('load', () => {
if (typeof window.module1_function === 'function') {
console.log('✅ Function ready:', window.module1_function());
// 输出:module1_function executed → 42
} else {
console.error('❌ module1_function still not available');
}
});
</script>
⚠️ 注意:不要使用
DOMContentLoaded—— 它在模块脚本执行前就可能触发(尤其当模块含异步操作或网络延迟时),而load确保所有<script type="module"></script>已完成执行。
✅ 正确方案二:动态 import()(推荐,更现代、无需污染全局)
避免将函数挂载到 window,彻底消除全局命名冲突与维护风险。只需修改模块导出方式,并在普通脚本中按需导入:
./js/module1.mjs
export const module1_function = () => {
console.log('module1_function executed');
return 42;
};
index.html 中的普通脚本
<script>
import('./js/module1.mjs')
.then(({ module1_function }) => {
console.log('✅ Imported & called:', module1_function());
// 输出同上
})
.catch(err => console.error('❌ Failed to load module:', err));
</script>
该方式支持错误处理、按需加载、Tree-shaking,且完全不依赖全局作用域——是现代 Web 应用的首选实践。
❌ 为什么 defer + 普通脚本仍失败?
-
defer对模块脚本无效且多余(MDN 明确说明:模块默认 deferred); - 普通脚本的
defer仅保证其执行在 DOM 解析完成后、DOMContentLoaded前,但不等待其他模块执行; - 浏览器按 HTML 中脚本声明顺序排队执行,但模块脚本与普通脚本属于不同任务队列(microtask vs. task),存在竞态。
总结
| 方案 | 是否需改模块代码 | 是否污染全局 | 兼容性 | 推荐度 |
|---|---|---|---|---|
window.addEventListener('load', ...) |
否 | 是 | ✅ IE9+ | ⭐⭐⭐ |
动态 import()
|
是(改为 export) |
否 | ✅ Chrome 63+/Firefox 67+/Safari 11.1+ | ⭐⭐⭐⭐⭐ |
如需快速修复遗留代码,用 load 事件;若追求可维护性与长期演进,请拥抱动态导入——它让模块边界清晰、依赖显式、逻辑解耦。










