新电脑装完Node.js后npm install卡在idealTree是因默认源registry.npmjs.org国内访问不稳定及缓存未优化所致，需切换为https://registry.npmmirror.com镜像源、清理并验证缓存、跳过可选依赖，或改用pnpm提速。
新电脑装完Node.js后第一次执行npm install，等了十分钟还没结束，依赖下载卡在fetching，终端反复打印“idealTree”进度条不动——这不是网络问题，而是npm默认源和缓存机制没调优导致的安装效率坍塌。
确认当前npm版本与缓存状态
打开CMD或PowerShell，先检查基础环境是否就绪：
node -v → 查看Node版本（必须≥16.0.0）
npm -v → 确认npm版本（推荐≥9.0.0，低于7.0.0请升级）
npm config get cache → 记下缓存路径，确保该目录所在磁盘剩余空间＞2GB
【缓存路径若落在C:\Users\用户名\AppData\Local\npm-cache且磁盘已满，后续所有install都会卡死】
切换国内镜像源（三选一）
方法一：全局配置淘宝镜像（已停用，不推荐）
npm config set registry https://registry.npm.taobao.org
方法二：使用官方推荐的npmmirror（当前最稳）
npm config set registry https://registry.npmmirror.com
方法三：临时单次生效（适合CI/CD或测试）
npm install --registry=https://registry.npmmirror.com
启用并验证缓存加速
第一步：清理旧缓存（避免损坏缓存引发重复下载）
npm cache clean --force
第二步：强制验证缓存完整性
npm cache verify
第三步：查看当前缓存大小与命中率
npm config list | findstr "cache"
这一步做完后，再次运行npm install，首次仍需下载，但第二次起相同包会直接从本地缓存读取，速度提升3～5倍。
安装时跳过可选依赖与完整脚本
很多前端包（如fsevents、canvas）在Windows上无法编译，npm会反复尝试并超时失败，拖慢整体进度。
执行以下命令跳过这些非关键依赖：
npm install --no-optional --ignore-scripts
【跳过--ignore-scripts后，webpack、vite等工具的postinstall钩子不会执行，若项目依赖这些钩子，请删掉该参数】
用pnpm替代npm（终极提速）
第一步：全局安装pnpm
npm install -g pnpm
第二步：进入你的前端项目根目录（含package.json）
第三步：执行迁移安装
pnpm install
pnpm采用硬链接+内容寻址存储，相同包在全盘只存一份，安装速度比npm快2～4倍，磁盘占用减少60%以上。它自动兼容npm的package.json和scripts，无需修改任何配置。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
