Parlons de la façon d'utiliser package.json pour la gestion des versions des packages dépendants

Cet article explique comment utiliser package.json pour effectuer la gestion des versions des packages dépendants dans des projets frontaux réels. Quel impact les différentes règles auront-elles sur la gestion des dépendances ?

Définition du numéro de version npm

Format de la version : X.Y.Z[-string]X.Y.Z[-string]
其含义为：

• X：主版本号
• Y：次版本号
• Z：修正版本号
• string: 先行版本号或版本编译信息

举个例子：

6.3.2-alpha的含义为：

• 主版本号6，有6次不可向下兼容的更新迭代。

• 次版本号3，有3次小的功能迭代。6.*.*

• 修正版本号2，有2次bug修改或其他非重大功能的修改。6.*.*

• 先行版本号alpha，表示处理试验阶段。

扩展阅读：语义化版本 2.0.0

package.json怎么识别依赖版本

将按下述代码进行阐释：

"vue": "~2.5.22",
"vue-class-component": "^6.0.0",
"vue-router": "3.0.1",
"express": "latest",
"mongoose": "*",

• 符号^：锁定主版本，可更新次版本号、修正版本号和先行版本号

  例如"vue-class-component": "^6.0.0"，安装依赖时，可以安装符合6.*.* 的任意版本，只要主版本号是6即可。

• 符号~：锁定主版本号和次版本号，可更新修正版本号和先行版本号

  例如"vue": "~2.5.22"，安装依赖时，可以安装符合2.5.*的任意版本。

• 空符号：锁定所有版本号

  例如"vue-router": "3.0.1"，只能安装版本为3.0.1的依赖包。

• 符号*：定义某个版本号范围

  例如vue-router": "3.0.*"，可以安装3.0固定的任意版本，比如3.0.1、3.0.2。

• latest：安装最新的稳定版本

• 例如"express": "latest"，可以安装4.18.1  (2022.06.13最新版本)。

• *：安装最新发布的版本，不一定是稳定版本

• 例如"mongoose": "*",可以安装6.0.0-rc2、3.9.7等。

• Git URL：使用Git上发布的包

  引用格式： <protocol>://[<user>[:<password>]@]<hostname>[:<port>][:][/]<path>[#<commit-ish> | #semver:<semver>]</semver></commit-ish></path></port></hostname></password></user></protocol>

"test": "git+ssh://git@github.com:npm/cli.git#v1.0.27"

扩展阅读：npm docs - dependencies

不要太相信npm包的版本号！

如题，这个是血的教训换来的经验。

笔者在使用system.js时，使用的版本限制是：system.js: "^6.3.2"。

在安装依赖的时候，意外安装了> 6.3.2的版本，导致项目运行出错。

原因就是system.js作者，没有按照semver规范，进行版本号命名，导致笔者的项目，引入了不可向下兼容的更新，进而使项目运行出错。

dependencies、devDependencies与peerDependencies

dependencies

生产环境中使用到的依赖，统一安装在dependencies下。

举个例子：

"dependencies": {
	"chalk": "^2.4.2",
	"commander": "^3.0.0",
	"fs-extra": "^8.1.0",
	"inquirer": "^6.5.0",
	"mem-fs": "^1.1.3",
	"mem-fs-editor": "^6.0.0",
	"shelljs": "^0.8.3"
}

上述代码，是笔者做的cli工具包的package.json中的片段。
shelljs用于操作文件，如果改在devDependencies声明，则用户安装当前工具包后，运行会报错。
因为devDependencies字段声明的依赖，在npm install 工具包时，是不会安装的。必须在dependenciesLa signification est :

• X : numéro de version majeur
• Y : numéro de version mineure
• Z : numéro de version révisée
• chaîne : numéro de version avancé ou informations de compilation de version

🎜Par exemple : 🎜🎜6.3.2-alpha est : 🎜

• 🎜Version principale numéro 6, il y a 6 itérations de mise à jour qui ne sont pas rétrocompatibles . 🎜
• 🎜Version numéro 3, il y a 3 petites itérations de fonctions. L'instruction de dépendance de 6.*.*
• 🎜Version corrigée numéro 2, avec 2 corrections de bugs ou d'autres modifications de fonctionnalités non majeures. L'instruction de dépendance de 6.*.*
• 🎜Le numéro de version avancée alpha indique la phase expérimentale de traitement. 🎜

🎜Lecture approfondie : Version sémantique 2.0.0🎜

Comment identifier les versions de dépendances dans package.json🎜🎜 sera expliqué selon le code suivant : 🎜

"devDependencies": {
	"@commitlint/cli": "^8.1.0",
	"@commitlint/config-conventional": "^8.1.0",
	"commitizen": "^4.0.3",
	"commitlint-config-cz": "^0.12.1",
	"cz-customizable": "^6.2.0",
	"standard-version": "^7.0.0"
}

🎜Symbole ^ : verrouille la version principale et peut mettre à jour le numéro de version mineure, le numéro de version révisé et le numéro de version avancée🎜🎜Par exemple "vue-class-component": "^6.0.0", lors de l'installation des dépendances, vous pouvez installer n'importe quelle version conforme à 6.*.*, à condition que la version principale le nombre est 6. 🎜

🎜Symboles ~ : verrouillez le numéro de version majeure et le numéro de version mineure, et mettez à jour le numéro de version révisé et le numéro de version avancée🎜🎜Par exemple "vue": "~2.5.22", lors de l'installation des dépendances, vous pouvez installer n'importe quelle version conforme à 2.5.*. 🎜

🎜Symbole vide : Verrouille tous les numéros de version🎜🎜Par exemple "vue-router": "3.0.1" code >, seuls les packages dépendants avec la version 3.0.1 peuvent être installés. 🎜

🎜Symbole* : Définissez une certaine plage de numéros de version🎜🎜Par exemple, vue-router": "3.0.*" code>, vous pouvez installer n'importe quelle version corrigée par 3.0, telle que 3.0.1, 3.0.2 🎜

🎜. dernière : Installez la dernière version stable🎜🎜🎜

• 🎜Par exemple, "express": "latest ", Vous pouvez installer 4.18.1 (la dernière version du 2022.06.13) 🎜
• 🎜* : Installer la dernière version publiée, pas nécessairement la dernière version stable🎜

🎜🎜

• 🎜Par exemple, "mongoose": "*", vous pouvez installez 6.0.0-rc2, 3.9.7 etc. 🎜
• 🎜Git URL : utilisez le package publié sur Git 🎜🎜Format de citation : <protocole> : //[<user>[:<password>]@]<hostname>[:<port>][:][/]<path> | #semver :&lt ;semver>]</path></port></hostname></password></user></protocole>🎜

{
  "name": "tea-latte",
  "version": "1.3.5",
  "peerDependencies": {
    "tea": "2.x"
  }
}

🎜Lecture approfondie : npm docs - dependencies🎜

Ne vous fiez pas trop au numéro de version du package npm ! 🎜🎜Comme le titre l'indique, c'est l'expérience acquise grâce aux leçons de sang. 🎜🎜Lorsque l'auteur utilise system.js, la limite de version utilisée est : system.js : "^6.3.2". 🎜🎜Lors de l'installation des dépendances, la version de > 6.3.2 a été accidentellement installée, entraînant un mauvais fonctionnement du projet. 🎜🎜La raison est que l'auteur de system.js n'a pas nommé le numéro de version conformément à la spécification semver, ce qui a entraîné l'introduction de pas à rebours mise à jour compatible, provoquant un mauvais fonctionnement du projet. 🎜

dépendances, devDependencies et peerDependencies🎜

dépendances

🎜Les dépendances utilisées dans l'environnement de production sont uniformément installées sous dependencies. 🎜🎜Par exemple : 🎜rrreee🎜Le code ci-dessus est un fragment du package.json de la boîte à outils cli créée par l'auteur. 🎜shelljs est utilisé pour faire fonctionner les fichiers. Si l'instruction est modifiée en devDependencies, une erreur sera signalée après que l'utilisateur aura installé le package d'outils actuel. 🎜Parce que les dépendances déclarées dans le champ devDependencies ne seront pas installées lorsque le npm install tool package. Doit être déclaré dans le champ dépendances avant d'être installé. 🎜

devDependencies

生产环境不需要使用的依赖，都需要安装在devDependencies下。
因为生产环境下，是不会安装devDependencies字段下的依赖的。

举个例子：

"devDependencies": {
	"@commitlint/cli": "^8.1.0",
	"@commitlint/config-conventional": "^8.1.0",
	"commitizen": "^4.0.3",
	"commitlint-config-cz": "^0.12.1",
	"cz-customizable": "^6.2.0",
	"standard-version": "^7.0.0"
}

上述代码，是笔者做的cli工具包的package.json中的片段。
commitizen是笔者用于规范Git提交规范的依赖包，只在开发环境中使用，所以在devDependencies中声明。

peerDependencies

当开发一些插件和工具包时，对使用方的运行环境的依赖包版本有要求，可以使用peerDependencies字段进行声明。

举个例子：

{
  "name": "tea-latte",
  "version": "1.3.5",
  "peerDependencies": {
    "tea": "2.x"
  }
}

当前工具tea-latte，依赖tea包。而且，要求tea包是主版本2。

当不满足要求时，控制台会进行报错处理。

注意
npm v7版本， peerDependencies会默认安装。
npm  v3 到 npm v6版本， peerDependencies不会自动安装。

更多node相关知识，请访问：nodejs 教程！

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!