刚才又有朋友问我 Vite 项目打包遇到无法下载依赖报错的问题，其实这个大部分原因就是源没切换成镜像加速，我就把常规遇到的问题记录下。

这次出去玩，还好带了笔记本，不然手机扣字真的累。

PS：如果是vs code一样要管理员运行，不然无法安装依赖，缺少权限。

检查 Node.js 和 npm 版本

确保您使用的 Node.js 和 npm 版本兼容 Vite。运行以下命令检查版本：

node -v
npm -v

• 推荐使用 Node.js 16.x 或更新版本。
• 如果版本太低，请升级 Node.js。

切换 npm 源（大部分报错都是源问题）

尝试使用淘宝镜像源或其他稳定的镜像源：

npm config set registry https://registry.npmmirror.com

然后重新安装依赖：

npm install

如果网络问题持续存在，可以清理缓存后重试：

npm cache clean --force

验证安装

完成后运行以下命令验证依赖是否安装正确：

npm list vite
npm list @vitejs/plugin-legacy
npm list vite-plugin-css-injected-by-js

• 如果结果中有 vite@x.x.x，表示 Vite 已安装。
• 如果没有显示 Vite，请重新安装 Vite：npm install vite --save-dev

如果一切正常，您可以重新运行打包命令：

npm run build

其他建议

如果您的网络环境持续不稳定，可以考虑使用 yarn 或 pnpm 替代 npm，它们在依赖管理和网络下载上更高效：

npm install -g yarn
yarn install
yarn build

推荐一个Node本地管理工具

下载地址：https://github.com/1111mp/nvm-desktop