React项目执行npm i时安装脚本卡死，求解决办法

你的npm i命令卡住的核心问题有两个：脚本命名冲突导致的逻辑异常，以及串行执行的安装流程中某一步出现阻塞。

1. 脚本命名冲突（关键问题） #

npm 默认会在执行npm i时，自动触发当前项目package.json里的install脚本。这就导致了两个问题：

• 根目录执行npm i时，会直接跳过根目录自身的依赖安装（如果有的话），直接进入你写的install脚本逻辑。
• 若子目录的npm i也触发类似钩子，可能引发不必要的递归执行。

修复方式：
把批量安装的脚本名从install改成setup或install-all，避免和npm的默认钩子冲突。修改后的scripts配置如下：

"scripts": {
  "start": "node server/server.js",
  "dev": "concurrently \"cd server && npm run watch\" \"cd client && npm start\"",
  "setup": "cd server && npm i && cd ../client && npm i",
  "build": "cd client && npm run build",
  "seed": "cd server && npm run seed",
  "test": "echo \"Error: no test specified.\" && exit 1",
  "eject": "react-scripts eject"
}

之后执行安装时：

• 如果根目录有依赖，先执行npm i安装根依赖，再执行npm run setup安装server和client的依赖。
• 如果根目录无依赖，直接执行npm run setup即可。

2. 定位具体阻塞环节 #

你的脚本用&&串行执行，只要其中某一步（server或client的npm i）卡住，整个流程就会停滞。可以单独测试两个子目录的安装命令：

• 先执行cd server && npm i，看是否能正常完成。
• 再执行cd client && npm i，排查哪个环节出问题。

常见阻塞原因及解决：

• 网络问题：切换国内npm源，执行npm i --registry=https://registry.npmmirror.com。
• 依赖冲突：删除子目录的node_modules和package-lock.json（或yarn.lock）后重新安装。
• npm版本过低：升级npm到稳定版，执行npm install -g npm。
• 权限/磁盘问题：Linux/macOS下加sudo执行，Windows用管理员终端启动命令行；检查磁盘空间是否充足。

3. 可选优化：并行安装 #

如果想加快安装速度，可以用concurrently并行安装两个子目录的依赖，修改setup脚本如下：

"setup": "concurrently \"cd server && npm i\" \"cd client && npm i\""

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