npm install 卡住或报 ETIMEDOUT/404 是因 VSCode 终端未正确加载私有源 .npmrc；需在项目根目录创建 UTF-8 无 BOM 的 .npmrc，内容为 registry=https://npm.example.com，并确保终端在项目路径下启动。
npm install 时提示 registry 不可用或超时
本地私有源配置失败最直接的表现就是 npm install 卡住、报 ETIMEDOUT 或返回 404 Not Found（尤其在访问 https://registry.npmjs.org 时）。这不是网络问题，而是 VSCode 终端或 npm 本身没读到你设的私有源。
关键点在于：VSCode 默认复用系统终端环境，但它的集成终端（Terminal）可能不继承 Windows 的用户级环境变量，也不自动加载 .npmrc 文件——除非你明确告诉它用哪个配置。
- 检查当前生效的 registry：
npm config get registry，必须输出你的私有源地址（如https://npm.example.com），而不是默认的https://registry.npmjs.org或淘宝镜像 - 确认配置位置优先级：npm 会按顺序读取
project/.npmrc→HOME/.npmrc→etc/npmrc，项目级配置会覆盖全局，容易误覆盖 - VSCode 内置终端若以非登录 shell 启动（比如未启用
"terminal.integrated.defaultProfile.windows": "PowerShell"），可能跳过 profile 加载，导致.npmrc未生效
在 VSCode 中让 npm 使用指定 .npmrc 文件
VSCode 不会自动识别或切换 npm 配置文件，它只认当前终端 session 里 npm 的运行时状态。想让每个项目用不同私有源，不能靠插件“选”，得靠路径和命令控制。
- 在项目根目录手动创建
.npmrc，内容只写一行：registry=https://npm.example.com（不要加空格、注释或 BOM） - 确保该文件编码为 UTF-8 无 BOM（用 VSCode 右下角编码菜单确认），否则 npm 会静默忽略
- 不要依赖 VSCode 设置里的
npm.packageManager，它只影响npm init行为，不改变 registry - 如果私有源需要认证，在同一
.npmrc中追加：//npm.example.com/:_authToken=xxxxxxxxxx（token 从私有源后台获取）
npm config set registry 失效的常见原因
执行 npm config set registry https://npm.example.com 后仍走默认源，大概率是配置写到了错误层级，或者被更高优先级的配置覆盖了。
- 运行
npm config ls -l查看所有配置来源，重点关注; "user" config from C:\Users\XXX\.npmrc和; "project" config from D:\myproj\.npmrc两行——后者会压倒前者 - 如果你在项目内执行了
npm config set，它默认写入 project 级，但 VSCode 终端若在父目录启动，就根本读不到这个.npmrc - Windows 上某些杀毒软件或企业组策略会重置
%APPDATA%\npm\etc\npmrc，导致全局配置被还原，建议优先用项目级.npmrc - Node.js 版本 ≥ v20.12 后，npm v10+ 默认启用
legacy-peer-deps=false，私有源若未同步上游 peerDependencies 元数据，也会触发看似 registry 错误的ERESOLVE报错
VSCode 调试时 node_modules 解析失败
即使 npm install 成功，VSCode 调试器（launch.json）仍可能报 Cannot find module 'xxx'，这是因为它不走 npm 的 resolve 逻辑，而是直接按 Node.js 原生规则查找 node_modules。
- 确保项目根目录有
package.json，且已成功运行过npm install（不是yarn或pnpm） - 在
launch.json中显式指定runtimeExecutable和env.NODE_OPTIONS通常无效；真正起作用的是cwd字段——必须设为项目根路径，例如："cwd": "${workspaceFolder}" - 如果私有源安装的包含二进制模块（如
fsevents），需确认构建时用了匹配的 Node.js ABI 版本；VSCode 调试器调用的node必须和npm install时用的是同一个可执行文件（检查which node和process.execPath）
.npmrc，也不会帮你校验 token 是否过期。每次切项目，记得先 cd 进去再开终端，别图省事在空白窗口里直接敲命令。 
