顶层 await 可行但需模块为 es module 且环境支持（node.js 14.8+ 或现代浏览器），用于模块顶层等待 promise，如加载配置、动态导入或初始化服务，按序执行并形成初始化屏障。
在顶层代码中直接使用 await 是可行的，但必须满足一个前提：该模块本身是 ES 模块（ECMAScript Module），且运行环境支持顶层 await（Node.js 14.8+ 或现代浏览器）。这样你就能在模块最外层（非函数内）等待 Promise 完成，比如动态加载配置、初始化依赖或预取远程资源。
确保模块类型为 ES Module
Node.js 中默认是 CommonJS，需显式启用 ESM：
- 在
package.json中添加"type": "module"； - 或使用
.mjs文件扩展名； - 浏览器中通过
<script type="module"></script>加载脚本。
直接 await 动态导入或异步初始化逻辑
顶层 await 常用于等待模块加载、配置读取或服务就绪：
const config = await fetch('/config.json').then(r => r.json());const utils = await import('./utils.mjs');await initDatabase(); // 假设 initDatabase 返回 Promise
注意：所有顶层 await 语句会按顺序执行，整个模块的执行会被阻塞，直到所有顶层 await 完成，之后其他模块才能导入它（相当于模块的“初始化屏障”）。
避免常见陷阱
顶层 await 不是万能的，需注意：
- 不能在 CommonJS（
.cjs或无type: module的.js）中使用，会报语法错误； - 不能在函数、循环或条件块中“模拟”顶层 await —— 必须字面量位于模块顶层；
- 若多个模块都有顶层 await，它们的执行顺序由导入图决定，可能影响启动性能，建议只用于必要的一次性初始化。
替代方案（兼容性要求高时）
如果需支持旧版 Node 或打包工具不完全兼容顶层 await，可退回到立即执行异步函数：
(async () => { const mod = await import('./foo.mjs'); })();- 把主逻辑封装进
main()并调用main().catch(console.error)； - 使用构建工具（如 Vite、Webpack）自动处理顶层 await，多数现代工具链已原生支持。
不复杂但容易忽略的是：顶层 await 的价值不在“写起来多简洁”，而在于让模块的依赖关系和初始化时机更清晰、更声明式。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
