升级Vite至5.4.0后package-lock.json中esbuild版本未更新的问题

1. Vite 版本绑定了特定 esbuild 版本 #

Vite 5.4.0 的官方依赖声明里，esbuild 的版本范围可能就是 ~0.21.3 这类限制，并非你操作有误。npm 会严格按照 Vite 依赖的版本范围安装，不会自动升级到最新的 0.23.0。

你可以通过以下命令验证这一点：

npm show vite@5.4.0 dependencies

执行后会看到 Vite 5.4.0 对 esbuild 的具体版本要求。

2. 其他依赖锁定了 esbuild 版本 #

项目中的其他依赖可能也依赖 esbuild，且指定了更低的版本要求，npm 解析时会选择满足所有依赖的最高兼容版本。

• 查看依赖树，定位哪些包限制了 esbuild：

  npm ls esbuild
  

• 若确需强制升级，可在 package.json 中添加 overrides 字段（npm 8+ 支持），强制所有依赖使用指定版本：

  {
    "overrides": {
      "esbuild": "0.23.0"
    }
  }
  

  添加后重新执行 npm install，但需注意：强制升级可能引发兼容性问题，务必测试项目能否正常运行。

3. npm 本地缓存残留 #

即便删除了 node_modules 和 package-lock.json，npm 本地缓存可能仍保留旧版本包，导致安装时复用缓存文件。

清理缓存后重新安装：

npm cache clean --force
npm install

4. 镜像源版本不同步 #

若使用第三方 npm 镜像源，可能存在版本同步延迟或缓存旧版本的情况。

切换到官方源后重试：

npm config set registry https://registry.npmjs.org/
npm cache clean --force
npm install

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