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
- npm:
确认本地Vite依赖
打开项目的package.json,检查devDependencies中是否包含vite。若缺失,手动安装:- npm:
npm install vite --save-dev - yarn:
yarn add vite --dev - pnpm:
pnpm add vite --save-dev
- npm:
规避全局依赖冲突
优先使用项目本地的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
- npm:
检查路径与权限
确保项目路径无特殊字符(如空格、非英文字符),且当前用户对项目文件夹拥有读写权限。验证Node.js版本
Vite要求Node.js版本至少为v16.0.0,执行node -v查看版本,若不符合要求,升级至稳定版。
内容的提问来源于stack exchange,提问作者Ayush Dhanbhar




