ES Modules 中不能直接导出 await 表达式，但可导出 async 函数或已执行的 Promise；推荐导出异步函数以支持多次调用和错误处理，若需模块加载时完成异步操作则用顶层 await（先赋值再导出）。
ES Modules 中不能直接导出一个 await 表达式，但可以导出异步函数本身（async function），也可以导出一个已执行的 Promise。关键在于区分“导出函数”和“导出等待结果”两种需求。
导出异步函数（推荐）
这是最常见、最安全的做法：把异步逻辑封装在 async function 里，然后正常命名或默认导出。调用方按需 await 即可。
- 函数体内部处理错误，外部调用更可控
- 支持多次调用，不依赖模块初始化时机
- 兼容所有 ESM 环境，无顶层 await 限制
示例：
utils.jsexport async function fetchUser(id) {
const res = await fetch(`/api/user/${id}`);
if (!res.ok) throw new Error('Failed to fetch user');
return res.json();
}
<p>// 可同时导出默认异步函数
export default async function initApp() {
console.log('starting...');
await fetchUser(1);
return 'ready';
}使用时：
import { fetchUser } from './utils.js';
import initApp from './utils.js';
<p>await fetchUser(42);
await initApp();导出已解析的异步值（需顶层 await）
如果确实需要模块加载时就完成异步操作（比如读取配置、初始化连接），可用顶层 await，但必须遵守规则：
- 先赋值给变量，再
export，不能写export default await …（语法错误） - 模块类型必须是
type="module"，Node 需 ≥14.8 且"type": "module" - 一旦 await 失败，整个模块加载中断，无法用顶层 try/catch 捕获
示例：
config.jsconst configPromise = fetch('/config.json').then(r => r.json());
<p>// ✅ 正确：先 await 赋值，再导出
const config = await configPromise;
export { config };
// 或 export default config;避免 CommonJS 混用陷阱
ESM 不支持 require()，所以不能在 ESM 文件中用 require('./xxx.js') 加载异步资源。若需动态加载或降级兼容：
- 用
import('./path.js')—— 返回 Promise，天然支持异步场景 - 旧环境不支持顶层 await？改用导出 Promise 实例 + 注释说明调用方式
- 不要在 ESM 中混写
module.exports或exports.xxx
按需导入与重命名保持一致
导出的是异步函数，导入时仍遵循 ESM 规则：
- 命名导出 → 必须用
{ fetchUser }导入 - 默认导出 → 用
import initApp from './utils.js'，名字可自定义 - 想批量导入？
import * as api from './utils.js'，然后await api.fetchUser(1)
