Windows 10环境下npm install速度慢且卡步骤的问题咨询

你已经完成.npmrc基础配置（自定义registry、关闭strict-ssl、配置证书密钥认证）的前提下，针对两个卡滞环节的排查方向如下：

卡滞在 npm WARN prepare removing existing node_modules/ before installation 环节的排查 #

• 优先处理Windows特有的文件句柄占用问题：之前运行残留的node后台进程会锁死node_modules目录，导致npm的删除操作无响应。直接打开任务管理器，结束所有node.exe进程，手动删除项目下的node_modules文件夹、package-lock.json文件后重新执行安装命令。
• 检查项目package.json的脚本递归触发问题：该警告是npm自动执行prepare安装钩子时触发的逻辑，如果prepare命令内嵌了重复的npm install逻辑，会触发死循环卡在删除步骤。可以临时绕过脚本钩子执行安装，运行命令 npm install --ignore-scripts，验证是否可以走完安装流程。

卡滞在 Running 'npm run build' in D:\Repositories\project\front 环节的排查 #

• 解决Windows路径长度限制问题：系统默认260字符的路径长度上限，会导致构建工具遍历项目文件时无响应。将项目移动到层级更浅的目录（如直接存放至D:\project\front，减少嵌套层级），同时在系统设置中启用Win32长路径支持。
• 调整node运行内存上限：Windows下node默认内存上限约1.4GB，即使是小项目，也可能因为缓存占满内存导致build进程无输出。执行build命令前，先在当前终端窗口运行配置命令 set NODE_OPTIONS=--max-old-space-size=4096，给node分配足够的运行内存后再执行build。
• 排查代理配置冲突：如果系统开启了全局代理，会和你自定义的.npmrc网络配置冲突，导致构建阶段拉取远程资源时一直等待无响应。临时清空.npmrc中的proxy、https-proxy字段，关闭系统全局代理后重试。

通用排查技巧 #

卡滞时不要仅盯着最后一行输出的内容判断问题，执行命令时追加--loglevel verbose参数输出全量日志，文件锁、权限拒绝、网络超时等真实报错信息，往往会隐藏在前面的日志流中，很多人因为只看最底部的警告行，忽略已经触发的错误导致反复试错解决不了问题。

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