顶层 await 自 es2022 起成为标准特性，需满足 type="module" 加载、环境支持（如 node.js ≥14.8）等条件，可直接在模块顶层 await 后导出变量，但不可 export default await ...，失败会致模块加载中断。
JavaScript 模块中不能直接在顶层使用 await（即“顶层 await”），但自 ES2022 起，它已成为标准特性——前提是模块以 type="module" 方式加载，且运行环境支持（如现代浏览器、Node.js 14.8+ 默认启用，Node.js 16+ 完全稳定）。因此，“在模块导出时使用顶层异步等待”是可行的，但需满足条件并注意写法。
✅ 支持顶层 await 的前提条件
确保以下任一情况成立：
- 浏览器中通过
<script type="module"></script>加载该模块 - Node.js 中文件后缀为
.mjs，或package.json中设置了"type": "module" - 运行环境版本达标（如 Node.js ≥14.8，推荐 ≥16.0）
✅ 正确写法：顶层 await + 命名/默认导出
你可以在模块顶层直接 await 一个 Promise，并用其结果赋值给导出变量：
// config.mjs
const response = await fetch('/api/config');
const config = await response.json();
// 可正常导出
export const API_URL = config.baseUrl;
export const TIMEOUT = config.timeout;
export default { API_URL, TIMEOUT };
等价地，也可用 await 后立即导出：
// auth.mjs
export const currentUser = await (async () => {
const res = await fetch('/api/user');
return res.ok ? await res.json() : null;
})();
⚠️ 注意事项与常见陷阱
-
不能在
export default await ...中直接写（语法错误），必须先赋值再导出，或用 IIFE 包裹 - 模块初始化会阻塞后续依赖模块的执行——所有
import该模块的地方，会等到顶层 await 完成才继续 - 若 await 失败（Promise reject），整个模块加载失败，抛出
TypeError，无法用try/catch在顶层捕获（需在 async 函数内处理） - CommonJS（
require()）不支持顶层 await，不可混用；动态import()是兼容方案
? 兼容性替代方案（不支持顶层 await 时）
若需适配旧环境，可改用异步函数封装 + 导出 Promise：
// legacy-config.js
export async function loadConfig() {
const res = await fetch('/api/config');
return res.json();
}
// 使用方：
// import { loadConfig } from './legacy-config.js';
// const config = await loadConfig();
或者用动态导入模拟顶层效果（适用于按需加载场景）：
// dynamic-init.mjs
export const init = (async () => {
const mod = await import('./config.mjs');
return mod.default;
})();
顶层 await 让模块初始化更直观，但本质仍是异步依赖管理。用好它，关键在明确环境约束和错误边界。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
