UNC路径下执行npm相关命令时CMD卡住无响应问题咨询

• Node.js及npm原生对UNC路径的支持存在缺陷：npm 7版本在处理文件系统IO时，会大量调用Windows API的路径校验逻辑，UNC路径（格式为\\server\share\path）的校验成本远高于本地盘符路径，大量并行的依赖写入操作会触发网络文件共享的锁机制，导致IO阻塞。
• 网络传输稳定性限制：UNC路径依赖局域网传输，npm install过程中会产生海量小文件的读写请求，网络延迟、共享服务器的IO性能瓶颈都会放大npm的IO等待时间，最终触发进程无响应。
• Angular CLI的依赖安装逻辑适配问题：ng new命令默认会在当前路径下执行嵌套的npm install逻辑，没有针对网络共享路径做IO队列优化，并发写入请求过多会直接触发共享目录的访问限制。

• 映射UNC路径为本地盘符
  打开cmd执行net use Z: \\你的服务器地址\共享文件夹名称，将UNC路径映射为Z盘（可替换为其他未使用的盘符），之后所有npm/ng操作都在映射后的盘符路径下执行，即可规避UNC路径的原生支持问题。
• 修改npm配置降低IO并发
  执行以下命令调整npm参数：

  npm config set cache "C:\npm-cache" --global
  npm config set maxsockets 5 --global
  npm config set registry https://registry.npmmirror.com/
  

  上述配置将npm缓存转移到本地磁盘减少共享路径IO，降低并发请求数避免网络阻塞，更换国内镜像减少外网拉取依赖的延迟。
• 降低UNC路径权限校验开销（可选）
  打开组策略编辑器，定位到「计算机配置>管理模板>网络>Lanman 工作站」，启用「启用不安全的来宾登录」选项，同时执行reg add HKLM\SYSTEM\CurrentControlSet\Services\LanmanWorkstation\Parameters /v AllowInsecureGuestAuth /t REG_DWORD /d 1 /f修改注册表，减少共享路径的权限校验耗时。
• 离线依赖同步方案
  可以先在本地磁盘完成npm install操作，再将整个node_modules文件夹同步到UNC路径下，避免直接在共享路径执行依赖安装操作。

内容的提问来源于stack exchange，提问作者Davis Jahn