npm install grunt --save-dev安装中断且未修改package.json的问题排查

可能原因 #

• npm缓存损坏：长期使用后缓存文件易出现异常，导致安装进程卡壳
• 网络访问不稳定：访问npm官方源速度慢，下载依赖时超时停滞
• 系统权限不足：Windows下当前用户无权限写入node_modules目录或修改package.json
• 依赖版本冲突：项目现有依赖与grunt存在版本兼容问题，解析依赖时卡住

解决方案 #

• 清理npm缓存
  执行命令：npm cache clean --force，清理完成后重新运行npm install grunt --save-dev

• 切换国内npm镜像源
  临时使用国内源安装：npm install grunt --save-dev --registry=https://registry.npmmirror.com
  或永久切换源：npm config set registry https://registry.npmmirror.com，之后再执行安装命令

• 以管理员身份运行终端
  在Windows中找到命令提示符或PowerShell，右键选择「以管理员身份运行」，再执行安装命令

• 删除旧依赖文件后重装
  删除项目根目录下的node_modules文件夹和package-lock.json文件，重新执行npm install grunt --save-dev

• 指定稳定版本安装
  尝试安装指定稳定版本，比如：npm install grunt@1.6.1 --save-dev（版本号可根据最新稳定版调整）

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