En détail
Une version s'écrit MAJOR.MINOR.PATCH, par exemple 2.4.1. On augmente MAJOR pour les changements incompatibles de l'interface publique, MINOR pour les nouveautés qui ne cassent pas le code existant et PATCH pour les corrections de bogues compatibles. Un tiret ajoute une étiquette de préversion (2.5.0-beta.1, classée avant 2.5.0) et un signe plus ajoute des métadonnées de build (2.5.0+20261028) ignorées lors des comparaisons. Les versions inférieures à 1.0.0 sont considérées comme instables : tout changement peut rompre la compatibilité.
Pourquoi c'est important
Les gestionnaires de paquets utilisent ces nombres pour choisir automatiquement les mises à jour. Une plage comme ^2.4.1 accepte toute version 2.x à partir de 2.4.1 mais pas 3.0.0, ce qui n'est sûr que si les auteurs respectent les règles. Rompre le contrat, par exemple en changeant le comportement dans un correctif, est une cause fréquente de builds du type « ça marchait hier ». Testez des plages avec le vérificateur de plages semver.
Exemple
En partant de 1.4.2 : un correctif donne 1.4.3 ; une nouveauté compatible donne 1.5.0 (le correctif revient à 0) ; supprimer une fonction donne 2.0.0 (mineure et correctif reviennent à 0). La plage ~1.4.2 accepte 1.4.9 mais pas 1.5.0.