当前位置: 首页 > web >正文

输入npm install后发生了什么

一、准备阶段:配置与环境检查

  1. 读取配置优先级
    npm install 首先加载多层级的配置(优先级从高到低)4:

    • 项目级 .npmrc

    • 用户级 .npmrc(如 ~/.npmrc

    • 全局 npmrc

    • npm 内置默认配置
      可通过 npm config ls -l 查看所有配置。

  2. 检查锁定文件

    • 若存在 package-lock.json
      对比其与 package.json 的依赖版本是否一致:

      • ✅ 一致 → 直接使用锁定文件中的依赖树。

      • ❌ 不一致 → 按 npm 版本策略处理(如 npm 5.x+ 会以 package.json 为准更新锁定文件)4。

    • 若无锁定文件 → 根据 package.json 递归构建依赖树4。


 二、依赖解析阶段:构建依赖树与扁平化

  1. 依赖树生成
    npm 解析 package.json 中的 dependencies 和 devDependencies,递归收集所有子依赖,形成树状结构4。

  2. 扁平化处理(Deduplication)

    • 将依赖按相同版本提升到 node_modules 根目录(如 react 只安装一份)。

    • 若版本冲突(如 A 依赖 lodash@^4.0,B 依赖 lodash@^3.0)→ 在 B 的 node_modules 下单独安装 lodash@3.x4。


三、安装阶段:缓存与下载

  1. 缓存查询

    • 每个包根据 name@version 生成唯一 Key,在缓存目录(npm config get cache,通常为 _cacache)中查找14。

    • 若缓存命中且校验通过(通过 integrity 字段验证完整性)→ 直接解压到项目 node_modules

  2. 远程下载

    • 若缓存未命中 → 从 npm 仓库(或配置的镜像如淘宝源)下载包。

    • 下载后:

      1. 校验完整性(SHA 摘要)。

      2. 存入缓存。

      3. 解压至 node_modules14。


📦 四、收尾阶段:写入与清理

  1. 生成/更新 package-lock.json
    记录所有依赖的精确版本、下载地址、依赖树结构,确保后续安装一致4。

  2. 运行生命周期脚本
    按顺序执行包中定义的脚本(如 preinstallpostinstall),某些包可能在此阶段编译原生模块。


⚠️ 五、常见问题与解决

问题场景原因与解决方案
安装后报错“模块找不到”缓存损坏或网络中断导致包不完整 → 清除缓存重试:
npm cache clean --force + 删除 node_modules 重装14。
node_modules 无法删除文件被进程占用 → 关闭 IDE(如 VSCode)或使用命令行强制删除12。
安全漏洞警告运行 npm audit 查看漏洞详情 → 使用 npm audit fix 自动修复,或手动升级受影响包7。
Linux 系统权限灾难⚠️ 历史教训:npm v5.7.0 在 sudo 下运行时递归修改系统目录所有权(如 /etc),导致系统崩溃 → 永远避免用 sudo 执行 npm!356。

💎 关键机制总结

  • 缓存优化:显著加速重复安装,但需注意缓存污染问题4。

  • 锁定文件作用:确保跨环境安装一致性,务必提交到版本控制

  • 安全审计npm audit 主动检测依赖链漏洞(如 react-native-validator-form 案例中的 Karma 漏洞)7

 流程图

http://www.xdnf.cn/news/15442.html

相关文章:

  • Maven 构建命令
  • HTML 基本骨架
  • 【LeetCode 热题 100】23. 合并 K 个升序链表——(解法一)逐一合并
  • DOS下EXE文件的分析 <1>
  • Linux锁的概念及线程同步
  • 【iOS】方法与消息底层分析
  • 深入了解JAVA中Synchronized
  • CCS-MSPM0G3507-7-模块篇-MPU6050的基本使用
  • 002大模型基础知识
  • 认识String、StringBuffer、StringBuilder
  • vue3 el-select默认选中
  • 【设计模式】策略模式(政策(Policy)模式)
  • 从 Manifest V2 升级到 Manifest V3 的注意事项
  • Cursor三大核心AI功能
  • 详解缓存淘汰策略:LFU
  • JS红宝书pdf完整版
  • mac上BRPC的CMakeLists.txt优化:解决Protobuf路径问题
  • SCTP协议网络编程
  • 【算法】贪心算法:柠檬水找零C++
  • Redis 命令总结
  • SpringBoot3-Flowable7初体验
  • Java 内部类详解:从基础到实战,掌握嵌套类、匿名类与局部类的使用技巧
  • Vivado ILA抓DDR信号(各种IO信号:差分、ISERDES、IOBUFDS等)
  • MYSQL笔记2
  • 4. MyISAM vs InnoDB:深入解析MySQL两大存储引擎
  • 39.Sentinel微服务流量控制组件
  • 论文笔记:AnImitation Learning Approach for Cache Replacement
  • Prometheus Operator:Kubernetes 监控自动化实践
  • 深入解析Hadoop架构设计:原理、组件与应用
  • Java 高级特性实战:反射与动态代理在 spring 中的核心应用