You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多
文档控制台
免费开始使用

Vite加载配置失败:本地及全局Vite包均无法加载,该如何解决?

Vite配置加载失败(ERR_MODULE_NOT_FOUND)解决方案

报错信息:

failed to load config from C:\Users\aayus\OneDrive\Documents\Desktop\PRO\vite\vite-project\vite.config.js
error when starting dev server:
Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'vite' imported from C:\Users\aayus\OneDrive\Documents\Desktop\PRO\vite\vite-project\node_modules\.vite-temp\vite.config.js.timestamp-1748432171854-eeb2e88fd07cf.mjs
    at Object.getPackageJSONURL (node:internal/modules/package_json_reader:256:9)
    at packageResolve (node:internal/modules/esm/resolve:768:81)
    at moduleResolve (node:internal/modules/esm/resolve:854:18)
    at defaultResolve (node:internal/modules/esm/resolve:984:11)
    at ModuleLoader.defaultResolve (node:internal/modules/esm/loader:780:12)
    at #cachedDefaultResolve (node:internal/modules/esm/loader:704:25)
    at ModuleLoader.resolve (node:internal/modules/esm/loader:687:38)
    at ModuleLoader.getModuleJobForImport (node:internal/modules/esm/loader:305:38)
    at ModuleJob._link (node:internal/modules/esm/module_job:137:49)

解决步骤:

  • 清理缓存与临时文件
    删除项目根目录下的node_modules文件夹、package-lock.json(或对应包管理器的锁文件),以及报错中提到的node_modules/.vite-temp临时目录。

  • 重新安装依赖
    根据你使用的包管理器执行对应命令:

    • npm:npm install
    • yarn:yarn install
    • pnpm:pnpm install
  • 确认本地Vite依赖
    打开项目的package.json,检查devDependencies中是否包含vite。若缺失,手动安装:

    • npm:npm install vite --save-dev
    • yarn:yarn add vite --dev
    • pnpm:pnpm add vite --save-dev
  • 规避全局依赖冲突
    优先使用项目本地的Vite启动服务,执行npm run dev(而非直接调用全局vite命令)。若必须使用全局命令,先卸载重装全局Vite:

    • npm:npm uninstall -g vite && npm install -g vite
    • yarn:yarn global remove vite && yarn global add vite
    • pnpm:pnpm remove -g vite && pnpm add -g vite
  • 检查路径与权限
    确保项目路径无特殊字符(如空格、非英文字符),且当前用户对项目文件夹拥有读写权限。

  • 验证Node.js版本
    Vite要求Node.js版本至少为v16.0.0,执行node -v查看版本,若不符合要求,升级至稳定版。

内容的提问来源于stack exchange,提问作者Ayush Dhanbhar

火山引擎 最新活动