执行vite build构建完成后进程挂起无法退出，如何解决？

• 临时应急终止
  直接在终端按 Ctrl + C（Windows/Linux）或 Cmd + C（Mac），可强制终止挂起的进程。

• 排查插件与配置问题
  进程挂起大多源于第三方插件未正确退出：

  • 逐个禁用项目中的第三方插件，重新执行vite build定位问题插件，之后调整该插件配置（比如关闭热更新、监听等非构建必需功能），或查看插件更新日志寻找修复方案。
  • 检查vite.config.js/vite.config.ts，确认是否误开启了server类监听配置（构建模式无需这些），或自定义的build钩子未正确触发完成回调。

• 清理依赖缓存
  删除node_modules文件夹和package-lock.json/yarn.lock，重新执行npm install或yarn install，排除依赖损坏引发的异常。

• 升级Vite版本
  旧版Vite存在构建后进程不退出的已知bug，执行npm update vite升级到最新稳定版后重试构建。

• 处理项目异步残留任务
  若项目存在未关闭的异步连接（如数据库、WebSocket）或未清除的全局定时器，会导致进程无法退出：

  • 修改package.json的构建脚本，添加强制退出逻辑：

    "scripts": {
      "build": "vite build && exit"
    }
    

  • 或在Vite配置中添加构建完成钩子：

    // vite.config.js
    export default {
      build: {
        async closeBundle() {
          process.exit(0);
        }
      }
    }
    

内容的提问来源于stack exchange，提问作者Stephani Bishop