npm run build 跑到一半直接中断,终端只留一行 Top-level await is not available in the configured target environment。日志里能对上时间点,这种反而好排。

构建目标默认按 browserslist 推导,落到不支持顶层 await 的 es 版本,Rollup 判断语法超出目标范围就拒绝输出。这一点先确认清楚,后面就不用反复试。

// vite.config.js
export default {
  build: { target: 'esnext' }
}
# 或 npx vite build --target esnext

「vite 构建目标」排查到最后往往是很小的一处差异,前面那些复杂猜测可以先放一放。能分两步做的操作就别合成一步,中间看一眼返回值,出问题好判断。

报错里带路径的,先去看那个路径在不在、权限对不对。同一份配置存在多处的,先确认改的是被加载的那一份。

新版本先放一台机器上跑一天再全量,问题一般在这段时间暴露。备份不是备了就行,恢复一次才算数,很多备份文件打开才发现是空的。

处理上按这个顺序:在 vite 配置里把 build.target 提到 esnext;确认依赖里没有更早的目标覆盖它;重新构建看是否还报同一句。

结果对不对很好判断,构建通过,产物里的顶层 await 保留下来,目标浏览器能正常执行。

作者 9823189