npm install卡在fetchMetadata是因registry.npmjs.org在国内TLS握手失败或DNS超时，需切换为https://registry.npmmirror.com/镜像源，清缓存并删除node_modules和package-lock.json后重试。
VSCode终端里npm install卡在fetchMetadata，不是网速慢
这不是本地带宽问题，而是npm默认registry（registry.npmjs.org）在国内无法稳定建立TLS连接，DNS解析常超时或被重置，导致卡在fetchMetadata或extract阶段。现象是命令长时间无响应、进度条不动、npm config get registry仍返回官方源。
- 先确认当前源：
npm config get registry，如果不是https://registry.npmmirror.com/（注意末尾斜杠），立刻切换 - 执行：
npm config set registry https://registry.npmmirror.com/ - 别用
cnpm：它生成的package-lock.json格式与npm不兼容，后续npm install会报Invalid package-lock.json - 改完后必须清缓存：
npm cache clean --force，再删掉node_modules和package-lock.json重试
为什么VSCode终端没继承系统代理设置
VSCode集成终端（尤其是PowerShell）默认不读取Windows系统代理（如Fiddler、Clash、Edge DevTools代理），也不加载用户级HTTP_PROXY/HTTPS_PROXY环境变量。即使你在CMD里能跑通npm install，VSCode终端也可能因缺失代理配置而失败。
- 检查当前终端是否设置了代理：
echo $env:HTTP_PROXY（PowerShell）或echo %HTTP_PROXY%（CMD） - 临时注入代理（仅当前会话）：
$env:HTTP_PROXY="http://127.0.0.1:7890"; $env:HTTPS_PROXY="http://127.0.0.1:7890" - 若用Clash或Surge，端口通常是
7890；Fiddler默认是8888，需确认代理监听地址是否为127.0.0.1而非localhost - 注意：PowerShell对
localhost有特殊解析逻辑，强制用127.0.0.1更可靠
npm install报EPERM或EACCES错误，本质是权限冲突
npm ERR! code EPERM或errno -4048这类错误，表面是“操作被拒绝”，实际多因npm缓存目录被杀毒软件、OneDrive或编辑器锁定，或当前用户对C:Users[user]AppDataRoaming
pm-cache无写权限。
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
- 不要直接用管理员身份运行VSCode——这会导致全局安装路径权限错乱，反而加剧问题
- 优先检查缓存路径是否被占用：
npm config get cache，然后手动打开该文件夹，看能否新建文本文件 - 若被OneDrive同步，右键文件夹 → “取消与OneDrive同步”，再重试
- 终极清理法：
npm config set cache "C: emp pm-cache"（确保C: emp存在且可写），再npm cache clean --force
VSCode settings.json里硬编码PATH不如重启终端有效
有人试图在settings.json里加"terminal.integrated.env.windows": { "PATH": "C:\Program Files\nodejs;${env:PATH}" }来修复npm找不到的问题，但实际效果有限——因为VSCode启动时已加载环境变量快照，修改JSON后不重启终端，PATH不会刷新。
- 真正生效的操作只有两个：彻底退出VSCode（任务栏右键→退出，不是关窗口），再重新打开
- 或者切换终端类型：右下角点击终端类型，从PowerShell切到
Command Prompt或Git Bash，它们对PATH继承更宽松 -
where npm（Windows）或which npm（macOS/Linux）必须返回有效路径，否则所有代理/镜像配置都白搭 - 如果
where npm无输出，说明Node.js安装路径根本没进系统PATH，此时修settings.json只是绕开真问题
最易被忽略的一点：VSCode终端是否继承了你手动设置的代理变量，取决于它启动时的父进程环境。哪怕你在系统环境变量里加了HTTP_PROXY，VSCode若从桌面快捷方式启动（而非命令行启动），就可能完全看不到这个变量。验证方式永远是echo $env:HTTP_PROXY，而不是假设它“应该”存在。
