npm install卡在fetchmetadata或extract阶段是因官方registry解析慢、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 get registry，如果不是https://registry.npmmirror.com（阿里云镜像），立刻切掉 - 执行
npm config set registry https://registry.npmmirror.com，注意不要漏掉https://和末尾斜杠 - 别用
cnpm—— 它会生成不兼容的package-lock.json，后续npm install可能报错Invalid package-lock.json - 改完后清缓存：
npm cache clean --force，再删掉node_modules和package-lock.json重试
VSCode 终端里 npm 命令找不到或权限被拒
VSCode 启动时可能没继承系统 PATH，或者 Windows PowerShell 默认策略禁止执行脚本，导致 npm 找不到或 pnpm 报 无法加载文件 … .ps1 错误。
- 检查 VSCode 终端是否为 PowerShell：右下角点击终端类型，优先切换成
Command Prompt或Git Bash - 若必须用 PowerShell，以管理员身份运行它，执行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser（不是LocalMachine，避免影响全局） - 重启 VSCode —— 仅关闭窗口无效，必须彻底退出（Windows 任务栏右键 → “退出”，macOS 用
Cmd+Q） - 验证
npm -v是否可执行；如果仍报错，手动把 Node.js 安装路径（如C:\Program Files\nodejs\）加进系统环境变量PATH
扩展安装慢不是网速问题，是 marketplace 直连失败
VSCode 默认连接 marketplace.visualstudio.com，这个域名在国内多数情况 DNS 污染或 TLS 握手失败，表现为搜索框转圈、安装按钮灰掉、进度条卡死。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 打开
settings.json（Ctrl+, → 右下角“打开设置 (JSON)”），**完全替换**extensions.gallery部分：
{
"extensions.gallery": {
"serviceUrl": "https://open-vsx.org/vscode/gallery",
"itemUrl": "https://open-vsx.org/vscode/item"
}
}
C/C++），去 https://open-vsx.org 网页搜，点 “Download” 拿到 .vsix 链接，再用 Extensions: Install from VSIX 命令本地装.vsix 解压，临时禁用再试依赖装得快，但项目跑不起来？检查 node_modules 结构和版本兼容性
镜像源加速后 npm install 很快完成，但启动报 Cannot find module 'xxx' 或 peer dep missing，往往不是网络问题，而是依赖树结构异常或版本冲突。
- 别混用
npm和pnpm或yarn：一个项目只用一种包管理器，否则node_modules目录结构不一致，require()会找不到路径 -
node-sass类原生模块容易出问题：先确认 Node.js 版本是否匹配（node-sassv7 要求 Node.js ≥ 16），不如直接换sass（Dart Sass） - Vue CLI 项目里如果用了
vue-cli-service serve启动失败，先运行npx vue-cli-service info查看实际加载的依赖版本，而不是只信package.json - 某些插件（如 Vetur）已停止维护，Vue 3 项目建议换
Vue Language Features (Volar)，否则即使装上也报语法错误
真正卡住的地方，从来不是“要不要换镜像”，而是换完之后没清缓存、没删 lock 文件、没彻底重启 VSCode；也不是“该不该用 pnpm”，而是用了却还在项目里留着 package-lock.json。这些细节不处理，再快的镜像也白搭。
