npm install的原理

npm install 原理流程图

缓存命中 缓存未命中 执行 npm install 解析 package.json 构建依赖树 检查缓存 npm cache 直接解压到 node_modules 从 Registry 下载包 下载压缩包 .tgz 校验完整性 SHA 存入缓存 npm cache 处理依赖嵌套 扁平化处理 node_modules 结构 处理版本冲突 生成 package-lock.json 完成安装


关键步骤解析

  1. 解析 package.json

    • 读取 dependenciesdevDependencies 字段,确定需要安装的包及版本范围。
  2. 构建依赖树

    • 分析直接依赖和间接依赖(嵌套依赖),形成完整的依赖关系树。
  3. 检查缓存

    • 查找本地缓存目录(~/.npm),如果包已缓存且版本匹配,则直接解压到 node_modules
  4. 下载包

    • 若缓存未命中,从 npm Registry(或配置的镜像源)下载压缩包(.tgz)。
  5. 校验完整性

    • 通过 SHA 校验文件完整性,防止篡改。
  6. 扁平化处理

    • npm v3+ 默认扁平化 node_modules,将依赖提升到顶层以减少嵌套(但可能引发版本冲突)。
  7. 版本冲突解决

    • 若同一包有多个版本,优先满足顶层依赖,其余版本嵌套安装在子目录中。
  8. 生成 package-lock.json

    • 锁定依赖版本和结构,确保下次安装结果一致。

补充说明

  • 缓存机制:npm 会优先使用本地缓存,显著加快安装速度。
  • 依赖提升:扁平化处理是为了解决 Windows 长路径问题,但可能导致"幽灵依赖"(未声明但能引用的包)。
  • 锁文件作用package-lock.jsonyarn.lock 确保团队协作时依赖版本一致。
相关推荐
Tachyon.xue2 小时前
Vue 3 项目集成 Element Plus + Tailwind CSS 详细教程
前端·css·vue.js
FuckPatience3 小时前
Vue 中‘$‘符号含义
前端·javascript·vue.js
东风西巷5 小时前
K-Lite Mega/FULL Codec Pack(视频解码器)
前端·电脑·音视频·软件需求
超级大只老咪6 小时前
何为“类”?(Java基础语法)
java·开发语言·前端
你的人类朋友8 小时前
快速搭建redis环境并使用redis客户端进行连接测试
前端·redis·后端
深蓝电商API9 小时前
实战破解前端渲染:当 Requests 无法获取数据时(Selenium/Playwright 入门)
前端·python·selenium·playwright
bestcxx9 小时前
(二十七)、k8s 部署前端项目
前端·容器·kubernetes
鲸落落丶9 小时前
webpack学习
前端·学习·webpack
excel10 小时前
深入理解 3D 火焰着色器:从 Shadertoy 到 Three.js 的完整实现解析
前端