npm install卡在fetchmetadata或extract是因registry.npmjs.org在国内解析慢、tls握手失败或cdn回源超时所致，应切换为https://registry.npmmirror.com/镜像源，清缓存并删除node_modules和package-lock.json后重试。
npm install 卡在 fetchMetadata 或 extract 怎么办
这不是网络卡顿，而是默认 registry.npmjs.org 在国内解析慢、TLS握手失败或CDN回源超时导致的。终端停在 fetchMetadata、extract 或某个包名不动，基本可以确定是源的问题。
- 先确认当前源：
npm config get registry，如果不是https://registry.npmmirror.com/（注意末尾斜杠），立刻切换 - 执行
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 错误
VSCode 启动时可能没继承系统 PATH，或者 Windows PowerShell 默认策略禁止执行脚本，导致 npm 找不到或 pnpm 报无法加载文件 … .ps1 错误。
- 检查 VSCode 终端类型：右下角点击终端图标，优先切换成
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
插件市场卡在“正在加载”或 code --install-extension 超时
改了 npm 源只解决依赖安装，VSCode 插件市场走的是另一套请求链路，默认连 marketplace.visualstudio.com，国内直连极易超时或被重置。
- 打开
settings.json（Ctrl+,→ 右下角“打开设置 (JSON)”），加入这两行（注意逗号分隔，且serviceUrl结尾不能带/）："extensions.gallery.serviceUrl": "https://vscode.cdn.azure.cn/_apis/public/gallery""extensions.gallery.cacheUrl": "https://vscode.cdn.azure.cn/_apis/public/gallery/publishers" - 改完后必须彻底退出 VSCode 进程，否则配置不生效
- 命令行安装失败？临时加环境变量：
VSCODE_EXTENSIONS_MSA_URL=https://vscode.cdn.azure.cn code --install-extension esbenp.prettier-vscode - 某些插件（如
ms-python.python）会额外拉语言服务器二进制包，这部分不走 gallery 协议，镜像源对其无效
为什么装完模块却 import 不到
常见于 VSCode 没有识别到刚装的模块，或 TypeScript 类型定义缺失，并非代码写错。尤其在切换源、重装依赖后容易出现。
- 重启 VSCode 的 TypeScript Server：按
Ctrl+Shift+P→ 输入Restart TS server回车 - 检查项目根目录是否有
tsconfig.json，确保"include"覆盖了源码路径，且未错误排除node_modules - 如果用的是 pnpm，确认
node_modules/.pnpm下对应包存在，且pnpm store status无异常 - VSCode 的 IntelliSense 缓存有时滞后，可删掉
.vscode/.suggestions（如有）或整个.vscode目录后重开
npm install 看似卡在某个包，实际是上游 registry TLS 握手失败；又比如插件市场“正在加载”，根源却是 serviceUrl 少了个下划线或结尾多了斜杠。这些细节不验证，换再多源也白搭。
