npm install卡在fetchMetadata或extract阶段是因registry.npmjs.org在国内解析失败、TLS握手超时或CDN回源失败所致，需切换镜像源为https://registry.npmmirror.com/，清缓存并删除node_modules和package-lock.json后重试。
npm install 卡在 fetchMetadata 或 extract 阶段
这不是网络慢，而是默认 registry registry.npmjs.org 在国内解析失败、TLS 握手超时或 CDN 回源失败所致。现象是终端长时间停在某个包名、fetchMetadata 或 extract，npm config get registry 仍返回官方源。
- 立刻执行
npm config set registry https://registry.npmmirror.com/（注意末尾斜杠和 https://） - 不要用
cnpm—— 它生成的package-lock.json与 npm 不兼容，后续npm install可能报Invalid package-lock.json - 改完后必须清缓存：
npm cache clean --force，再删掉node_modules和package-lock.json重试
VSCode 终端里 npm 命令找不到或报“无法加载文件 .ps1”
这和系统代理无关，而是 PowerShell 执行策略阻止了 npm 包内脚本（如 node-gyp 调用的 .ps1 文件）运行，常见于 Windows 默认终端。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 右下角点击终端类型，优先切换成
Command Prompt或Git Bash（最省事） - 若坚持用 PowerShell：以管理员身份打开它，运行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（不是LocalMachine） - 重启 VSCode 必须彻底退出：Windows 任务栏右键 → “退出”，macOS 按
Cmd+Q；仅关窗口不生效 - 验证：
npm -v能返回版本号才算成功
代理设置冲突导致 npm i 失败或证书错误
即使开了系统代理（如 Clash、Surge），npm 也可能因代理配置残留或 HTTPS 证书校验失败而卡死或报 ERR_SSL_CERT_VERIFICATION。
- 检查当前代理：
npm config get proxy和npm config get https-proxy，非空则说明有残留 - 清除代理：
npm config delete proxy和npm config delete https-proxy - 禁用严格证书校验（仅临时调试）：
npm config set strict-ssl false，但上线前务必设回true - 如果公司网络强制走代理，应统一配置镜像源 + 显式设置
https-proxy，而非依赖系统级代理
node-sass / sharp 等原生模块安装失败
这类模块需编译二进制，容易因代理、镜像源或构建工具缺失失败，错误常含 node-gyp rebuild、build.js 或 sass_binary_site。
- 单独设置二进制下载源：
npm config set sass_binary_site https://npmmirror.com/mirrors/node-sass/ - 同理设置：
npm config set electron_mirror https://npmmirror.com/mirrors/electron/、npm config set sharp_dist_base_url https://npmmirror.com/mirrors/sharp-libvips/ - 确保已安装 Python 3.10（
node-gyp要求）和 Visual Studio Build Tools（Windows）或 Xcode Command Line Tools（macOS） - 避免在 OneDrive/iCloud 同步目录或含中文/空格路径下运行
npm install
package-lock.json，或关了系统代理却没删 npm 的 proxy 配置——都可能让 npm install 表面正常实则暗中降速或失败。 
