npm install报错404

npm install报错404

yudao-ui-admin-vue3 Windows 构建问题最终整理
场景：Windows + Node.js + npm / pnpm
结论：是环境与镜像问题

解决方案

Step 1：切换回官方 npm 源（关键步骤）

npm config set registry https://registry.npmjs.org/

验证：
npm config get registry
必须输出：https://registry.npmjs.org/

⸻

Step 2：关闭所有可能锁文件的进程

•	关闭 VS Code / WebStorm
•	关闭所有 Node 调试会话
•	不要在资源管理器中打开项目目录

然后执行：

taskkill /F /IM node.exe

⸻

Step 3：彻底清理依赖（Windows 必须暴力）

Remove-Item node_modules -Recurse -Force -ErrorAction SilentlyContinue
Remove-Item package-lock.json -Force -ErrorAction SilentlyContinue

⸻

Step 4：安装全部依赖（包含 devDependencies）

npm install --include=dev

说明：
• 该步骤必须 完整执行成功
• 过程中 不能再出现 404 错误

⸻

Step 5：验证 vite 是否正确安装（验收点）

dir node_modules.bin\vite*

期望结果：

vite
vite.cmd

若不存在：

说明依赖安装未成功，不要继续下一步

⸻

Step 6：启动开发环境

npm run dev

⸻

推荐的 Windows 前端工程底线配置
• Node.js：18 LTS（优先）
• 包管理器：npm（先跑通再谈优化）
• Registry：https://registry.npmjs.org/
• IDE：避免在 install 过程中 attach / debug Node