npm install的执行原理
1. npm install 概述
npm install 是 Node.js 的包管理工具 npm 提供的一个命令，主要用于安装 package.json 文件中列出的依赖包。npm install 可以用于安装单个包、多个包，或者是根据项目中的 package.json 自动安装所有依赖。
通过 npm install，开发者可以下载并安装项目所依赖的各种库和工具，构建出一个完整的开发环境。在执行 npm install 时，npm 会从 npm registry（默认是 https://registry.npmjs.org）下载依赖包，并根据 package.json 和 package-lock.json 文件的内容来管理依赖关系。
2. npm install 执行流程
npm install 命令的执行过程可以分为以下几个步骤：
2.1 读取配置文件
执行 npm install 后，npm 会首先读取当前项目根目录下的 package.json 文件。package.json 文件定义了项目的元信息、依赖列表、版本信息以及其他配置。
- dependencies: 项目运行时所需的依赖。
- devDependencies: 项目开发时所需的依赖（如测试框架、构建工具等）。
- peerDependencies: 兼容性依赖，指定库或框架的兼容版本。
- optionalDependencies: 可选的依赖，安装时不会影响项目的正常运行。
如果 npm install 没有指定某个包，则默认会安装 dependencies 和 devDependencies 中列出的所有依赖。
2.2 检查锁文件
npm 会检查项目中是否存在 package-lock.json 或 npm-shrinkwrap.json 文件。package-lock.json 文件会记录每个依赖包的确切版本号以及它们的依赖关系，确保团队协作中每个开发者的开发环境一致。npm 会根据该文件来精确安装依赖包的版本，而不是通过 package.json 中的版本范围进行匹配。
- 如果存在
package-lock.json文件，npm 会严格根据其中的依赖树安装所有包，确保所有的依赖版本完全一致。 - 如果没有
package-lock.json文件，npm 将根据package.json中指定的版本范围来安装依赖包。
2.3 解析依赖
npm 会从 npm registry 获取各个包的信息。它会根据 package.json 中列出的依赖以及 package-lock.json（如果有的话）中的版本信息来解析出所有需要安装的包。
npm 会根据依赖的版本范围、版本号以及依赖关系来确定需要安装的包。例如，如果 package.json 中的某个包指定了 ^1.0.0，npm 会安装大于等于 1.0.0 且小于 2.0.0 的最新版本。
2.4 下载和安装依赖
一旦确定了要安装的包，npm 会开始下载依赖包。在下载过程中，npm 会在本地缓存已安装的包，以避免重复下载。npm 会将这些依赖包安装到 node_modules 目录中，node_modules 目录是存储项目依赖的地方。
- 缓存机制: npm 会在本地缓存下载过的包，以便下次安装时直接从缓存中取用，而不必重新从网络上下载。这能加快安装速度并减少带宽消耗。
- 扁平化安装: npm 会尝试将依赖包扁平化安装，避免依赖树中的重复依赖包。例如，如果有两个包都依赖于
lodash，npm 会将lodash安装到项目的顶层node_modules中，而不是每个包的子目录中。
2.5 更新锁文件
如果项目中存在 package-lock.json 文件，并且安装的依赖版本有变化，npm 会自动更新 package-lock.json 文件。这个文件会记录所有安装的依赖包的确切版本号及其依赖关系，以确保项目中所有开发者的安装结果一致。
2.6 运行生命周期脚本
在依赖安装完成后，npm 会执行一些生命周期脚本（如果定义了的话）。常见的生命周期脚本包括：
- preinstall: 安装依赖包之前执行的脚本。
- install: 安装依赖包时执行的脚本。
- postinstall: 安装依赖包后执行的脚本。
这些生命周期脚本通常用于执行一些自定义操作，如编译代码、生成文件、运行测试等。
3. 锁文件与版本管理
3.1 package-lock.json
package-lock.json 文件的作用是确保每次安装依赖时的版本一致性。它记录了每个依赖包的版本信息及其依赖树，确保无论在哪个环境中运行，依赖的版本都相同，从而避免不同环境下出现“它在我机器上可以运行”的情况。
- 固定版本:
package-lock.json文件记录了确切的包版本，而不是package.json中定义的版本范围。 - 依赖树: 文件中列出了每个依赖的确切版本以及它们的依赖关系，保证依赖关系的稳定性。
3.2 版本范围
在 package.json 中，依赖的版本号并不是一个固定值，而是一个范围。例如：
"lodash": "^4.17.0"：安装大于或等于4.17.0且小于5.0.0的版本。"express": "~4.17.1"：安装大于或等于4.17.1且小于4.18.0的版本。
这些版本范围有助于确保项目使用的依赖包不至于太老，也不至于被新版本的 API 变动所破坏。
4. 常见问题与调试
4.1 依赖冲突
依赖冲突通常发生在多个包依赖于不同版本的同一依赖时。npm 会尽量避免重复安装依赖，但如果无法避免，npm 会为每个包安装不同版本的依赖。
- 解决方法: 可以通过运行
npm ls来查看当前项目中安装的依赖版本。如果出现版本冲突，可能需要手动调整package.json中的版本范围。
4.2 缓存问题
npm 会缓存已安装的包，以提高安装效率，但有时缓存中的包可能会出现问题（例如损坏的包或错误的版本）。在这种情况下，可以使用 npm cache clean --force 来清除缓存并重新安装依赖。
4.3 安装失败
如果安装依赖时出现失败，可能是由于网络问题、版本冲突、权限问题等。常见的解决方法包括：
- 检查网络连接是否正常。
- 检查是否有权限问题（例如在全局安装时需要使用
sudo）。 - 删除
node_modules目录和package-lock.json文件，重新运行npm install。
关注微信公众号温暖前端，不定期分享前端知识点和前端资料↓↓↓