编辑
相信前端的小伙伴稍微入行一段时间的,接触过不同的项目,就可能遇到过npm install卡住的情况,下面我就来分析下几种场景、定位的方法和解决办法。不再只是删除node_modules然后重来了,虽然它能解决80%的问题
1 npm install 的原理
1.1 读取 package.json
文件
读取项目根目录下的 package.json
文件,确认当前项目所依赖的模块及其版本。
1.2 解析依赖关系
基于依赖的版本信息解析出需要安装的具体版本,并处理依赖之间的版本冲突等问题,最终生成一个依赖树。
**注意如果有lock文件,会按照lock文件来
1.3. 下载模块
根据解析的依赖树,npm
会从注册源头载所需的模块包。
** 如果本地缓存有,会读取本机的缓存
1.4. 安装模块
- 下载的模块会解压到
node_modules
目录下,并会处理依赖树中每个模块的依赖,确保每个模块都有其所需的依赖项。
1.5. 生成或更新 package-lock.json
- 安装完成后,
npm
会更新或生成package-lock.json
文件,以确保以后可以确定性地安装相同版本的依赖。
1.6. 执行生命周期钩子
- 有些包会在安装过程中触发钩子(如
preinstall
,postinstall
),执行额外的任务。
从上面六个步骤就可以看到一些问题了,首先1很难会卡住但可能格式不对会报错,4,5也很难卡住但可能因为权限问题无法写入。于是可以从 2 3 6 来分析了
2 可能原因和解决办法
2.1 网络问题
- 问题描述:
npm install
的过程中,需要从 npm 官方仓库或代理服务器上下载依赖包。如果网络不通畅,下载速度过慢,或者请求超时,可能会导致安装过程卡住,甚至失败。
- 解决方法:
- 切换 npm 源,使用国内镜像源,如淘宝镜像:
# 注意啦,天大的事情啦!!淘宝源2023年底就换新域名啦! npm config set registry https://registry.npmmirror.com
![node环境之Error: Cannot find module ‘chalk’ 报错无法解决的问题—-网上说让你npm install chalk 基本是没有用的-优雅草央千澈解决方案](https://ucc.alicdn.com/pic/developer-ecology/oapu2a2t6nd3o_7b815006ffd34c929be9efff8fb9ea30.png?x-oss-process=image/resize,h_160,m_lfit)
![node环境之当我们遇到需要付费的依赖库@fortawesome/fontawesome-pro导致npm install无法进行怎么办-fontawesome-pro依赖库](https://ucc.alicdn.com/oapu2a2t6nd3o/developer-article1647917/20250103/21fa39209d964319bea7101aea8f9cdc.png?x-oss-process=image/resize,h_160,m_lfit)
![前端全栈之路Deno篇(二):几行代码打包后接近100M?别慌,带你掌握Deno2.0的安装到项目构建全流程、剖析构建物并了解其好处](https://ucc.alicdn.com/ofgngjeebwaio/developer-article1631167/20241029/e7006fd2b0bd4d5da5767e53f5975a36.png?x-oss-process=image/resize,h_160,m_lfit)