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

输入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.lryc.cn/news/587457.html

相关文章:

  • C++高频知识点(十)
  • Excalidraw:一款颠覆传统思维的免费开源绘图工具
  • 什么是RAG(Retrieval-Augmented Generation)?一文读懂检索增强生成
  • Vue3 实现文件上传功能
  • 【操作系统】strace 跟踪系统调用(一)
  • 网络编程 JAVA
  • 2025年渗透测试面试题总结-2025年HW(护网面试) 45(题目+回答)
  • 学习开发之无参与有参
  • 前四天综合总结
  • Cursor的使用
  • ARC 03 从Github Action job 到 runner pod
  • 暑期自学嵌入式——Day01(C语言阶段)
  • BERT系列模型
  • Spring AI 项目实战(十六):Spring Boot + AI + 通义万相图像生成工具全栈项目实战(附完整源码)
  • 闲庭信步使用图像验证平台加速FPGA的开发:第十三课——图像浮雕效果的FPGA实现
  • 【Mysql作业】
  • 16.使用ResNet网络进行Fashion-Mnist分类
  • [GWCTF 2019]我有一个数据库
  • 在 Ubuntu 下安装 MySQL 数据库
  • 谷歌推出Vertex AI Memory Bank:为AI智能体带来持久记忆,支持连续对话
  • 【echarts踩坑记录】为什么第二个Y轴最大值不整洁
  • 华为HarmonyOS 5.0深度解析:跨设备算力池技术白皮书(2025全场景智慧中枢)
  • JavaScript加强篇——第八章 高效渲染与正则表达式
  • vue防内存泄漏和性能优化浅解
  • PHP语法高级篇(二):文件处理
  • 小架构step系列13:测试用例的加载
  • python的平安驾校管理系统
  • C# 接口(接口可以继承接口)
  • MySQL SQL语句精要:DDL、DML与DCL的深度探究
  • 大模型-量化技术