Windows 10系统下NPM运行速度极慢问题求助

一、优先排查npm全局性能异常 #

（npm -version本身需要10-20秒返回是核心异常点，正常情况下该命令执行耗时不会超过1秒）

• 清理npm缓存，执行命令：
  npm cache clean --force
  缓存损坏、冗余文件堆积是npm执行卡顿的最常见原因。
• 检查npm源配置，执行npm config get registry查看当前使用的源。如果当前为境外官方源，切换为国内镜像源，执行命令：
  npm config set registry https://registry.npmmirror.com/
  源的访问延迟高会拖累所有npm相关命令的执行效率。
• 校验npm配置是否存在异常：执行npm config list查看所有生效配置，确认没有配置错误的代理、无效镜像路径、缓存路径。
• 排查系统安全软件拦截：Windows Defender或第三方杀毒软件会对Node.js执行的脚本做实时扫描，将Node.js安装目录、项目所在目录加入安全软件的扫描白名单后重试，这是Windows环境下npm执行卡顿的高频诱因。
• 检查系统环境变量配置：确认Node.js和npm的安装路径在系统PATH变量的靠前位置，避免系统遍历大量无关路径才定位到npm执行文件。

二、项目层面性能优化 #

完成上述排查后如果react-scripts相关命令依然运行缓慢，再做项目侧优化：

• 清理冗余依赖后重新安装：

rd /s /q node_modules
del package-lock.json
npm install

（如果在git bash下执行，对应替换为rm -rf node_modules和rm package-lock.json）
依赖树异常、依赖版本冲突会大幅拖慢react-scripts的编译启动速度。

• 整理项目目录结构：不要把大体积静态资源（视频、压缩包、未压缩的高清图片等）放在src目录下，react-scripts启动时会默认扫描src下所有文件，冗余文件会大幅拉长扫描耗时。
• 升级react-scripts到最新稳定版：旧版本react-scripts存在已知的编译性能问题，执行命令升级：
  npm install react-scripts@latest
• 可以切换使用pnpm作为包管理器，相比npm的依赖解析、安装、执行速度都有明显提升。

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