npm install卡在fetchmetadata或extract是因registry.npmjs.org在国内解析慢、tls握手失败或cdn回源超时，需切换为https://registry.npmmirror.com/镜像源，清缓存并删除node_modules和package-lock.json后重试。
VSCode 里 npm install 卡在 fetchMetadata 或 extract，不是你网速差，是默认源 registry.npmjs.org 在国内解析慢、TLS 握手失败或 CDN 回源超时——换镜像源 + 清缓存才是正解。
确认并切换 npm 镜像源为阿里云
别信“试试看”，必须改。先查当前源：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 - 别漏掉
https://和结尾/，少一个都会导致 404 或静默失败
清缓存 + 彻底重装依赖
改完源不清理，旧缓存仍会拉取错误元数据。必须连带删掉所有残留：
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 运行
npm cache clean --force - 手动删除项目根目录下的
node_modules和package-lock.json - 再执行
npm install—— 这步不能跳，否则可能复用损坏的缓存
VSCode 终端里 npm 找不到或报权限错误
这不是 Node 没装好，而是 VSCode 启动时没继承系统 PATH，或 PowerShell 策略阻止脚本执行：
- 右下角点击终端类型，优先切到
Command Prompt或Git Bash - 若坚持用 PowerShell，以管理员身份打开它，运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（不是LocalMachine） - 彻底退出 VSCode：Windows 任务栏右键 → “退出”，macOS 按
Cmd+Q，仅关窗口无效 - 重启后验证：
npm -v能输出版本号才算生效
下载依然卡住？检查是否被代理或杀毒软件干扰
有些安全软件会拦截 TLS 流量，导致 npm 请求卡在 handshake；Clash、Surge 等代理开启时未设全局规则也会让请求走错路径：
- 临时关闭杀毒软件或防火墙，再试一次
npm install - 如果用了代理工具，确保 VSCode 是通过代理启动的，或显式禁用：
code --proxy-settings=off - 某些包（如
node-sass）还会单独请求二进制文件，这部分不走 registry，需额外配置NODE_SASS_BINARY_SITE环境变量
最易被忽略的一点：VSCode 的终端和系统终端看到的 npm 可能不是同一个——which npm（macOS/Linux）或 where npm（Windows）的结果，要和 npm -v 输出一致，否则你改的配置根本没生效。
