在现代的 JavaScript 生态系统中，管理依赖关系是开发过程中至关重要的一环。package.json 文件作为 Node.js 项目的核心配置文件，不仅定义了项目的基本信息和脚本命令，还包含了对项目所依赖的软件包的声明。其中，engines 和 peerDependencies 是两个关键的字段，它们对于确保项目的可靠性和可移植性至关重要。本文将深入探讨这两个字段的作用、用法以及在实际项目中的应用场景。
1. engines 字段
engines 字段用于指定项目运行所需的 Node.js 版本范围。它的主要作用是确保项目在指定的 Node.js 版本下能够正常运行，以避免因为运行环境不匹配而导致的不稳定或错误。
1.1 语法
engines 字段的语法很简单，通常被定义在 package.json 文件的顶层，格式如下：
"engines": {
"node": ">=8.0.0"
}
其中，node 是指定 Node.js 的版本，后面的值则是一个语义化的版本范围，可以使用任何 npm 支持的版本规范，如 >=8.0.0、^10.0.0 等。
1.2 作用
指定 engines 字段的作用有以下几点：
-
确保运行环境兼容性：通过明确指定项目运行所需的 Node.js 版本范围，可以确保项目在符合要求的 Node.js 版本下能够正常运行，避免由于 Node.js 版本不匹配而引发的兼容性问题。
-
提供警告信息：当用户尝试在不符合
engines字段指定范围内的 Node.js 版本下安装项目依赖时，npm 会发出警告，提醒用户当前 Node.js 版本可能不兼容，建议升级或更换 Node.js 版本。 -
更好的可移植性：在团队合作或者开源项目中，明确指定项目所需的 Node.js 版本范围可以提高项目的可移植性，使得其他开发者能够更容易地在相同的 Node.js 版本下进行开发和测试。
1.3 示例
{
"name": "my-project",
"version": "1.0.0",
"engines": {
"node": ">=16.15.1"
},
"dependencies": {
"express": "^4.17.1"
}
}
在这个示例中，engines 字段指定了项目运行所需的 Node.js 版本范围为 >=12.0.0，同时项目依赖了 Express 框架。当其他开发者尝试安装该项目时，npm 会检查当前 Node.js 版本是否符合要求，并在不符合要求时给出警告。
2. peerDependencies 字段
与 engines 字段类似，peerDependencies 字段也是用于声明依赖关系的一种方式，但其作用略有不同。peerDependencies 用于声明项目与其他软件包的关系，但是这种关系并不是一种直接的依赖关系，而是一种“同级依赖”关系。
2.1 语法
peerDependencies 字段的语法如下：
"peerDependencies": {
"package-name": "version"
}
其中，package-name 是指所依赖的软件包名称，version 则是对该软件包的版本范围进行声明。与 dependencies 不同的是，peerDependencies 声明的软件包不会被自动安装，而是需要由项目的开发者手动安装。
2.2 作用
peerDependencies 字段的作用主要体现在以下几个方面：
-
解决依赖冲突：在一些情况下，不同的软件包可能依赖于同一个软件包的不同版本，导致依赖冲突。通过使用
peerDependencies字段，可以将共享的依赖声明为同级依赖，从而避免因为依赖冲突而导致的问题。 -
提供可选依赖支持：有些软件包可能提供了可选的功能，如果项目需要使用这些功能，可以通过声明
peerDependencies来表明对这些可选功能的依赖，使得开发者能够根据项目需求来选择是否安装。 -
增强模块化：通过将一些功能模块声明为
peerDependencies，可以将项目的功能模块化程度提高，使得各个功能模块之间的关系更加清晰。
2.3 示例
{
"name": "my-project",
"version": "1.0.0",
"peerDependencies": {
"react": "^16.0.0"
},
"dependencies": {
"react-router": "^5.0.0"
}
}
在这个示例中，peerDependencies 字段声明了项目对 React 的同级依赖关系，并指定了版本范围为 ^16.0.0。当其他开发者手动安装项目时，npm 不会自动安装 React，而是需要开发者手动安装符合 peerDependencies 所指定版本范围的 React。不然会报大量的warning，但是可以在最后加上 –force这种命令消除警告。
`
原文链接：https://juejin.cn/post/7345071341483704372 作者：饺子不放糖
