Salta al contenuto principale

Calcolatore SemVer

Inserisci la versione corrente e il tipo di commit per ottenere la prossima versione SemVer, il git tag e uno stub di changelog.

Prossima versione
1.5.0
MINOR (new feature)
Git tag
v1.5.0
Changelog stub
## [1.5.0] - 2026-08-31

### Features

- <!-- describe change here -->
Comandi git
git tag -a v1.5.0 -m "Release 1.5.0"
git push origin v1.5.0

Come utilizzare Calcolatore SemVer

Inserisci la versione corrente

Digita la versione SemVer attuale del tuo pacchetto (es. 1.4.2 o v2.0.0) nel campo "Versione corrente".

Scegli il tipo di commit

Seleziona il tipo di modifica secondo Conventional Commits (BREAKING CHANGE, feat, fix, chore, docs, refactor, perf) per determinare quale numero incrementare.

Leggi la prossima versione e il git tag

Il tool calcola automaticamente la nuova versione SemVer, il change type (MAJOR/MINOR/PATCH) e il git tag corrispondente.

Copia changelog e comandi git

Usa i pulsanti "Copia" per copiare lo stub di changelog e i comandi git tag / git push pronti all'uso.

Suggerimenti

  • Usa sempre BREAKING CHANGE quando la modifica rompe la compatibilità con l'API pubblica precedente.
  • Copia i comandi git tag -a e git push origin nell'ordine mostrato per pubblicare correttamente il nuovo tag.
  • Aggiorna manualmente lo stub di changelog con una descrizione chiara prima di includerlo nel CHANGELOG.md del progetto.

Domande frequenti

Come funziona l'incremento SemVer secondo Conventional Commits?

BREAKING CHANGE incrementa MAJOR e azzera minor/patch; feat incrementa MINOR e azzera patch; fix, chore, docs, refactor e perf incrementano solo PATCH.

Che formato di versione accetta il campo "Versione corrente"?

Il formato SemVer standard MAJOR.MINOR.PATCH, con o senza prefisso "v" e con eventuale suffisso prerelease, ad esempio 1.4.2, v2.0.0 o 1.0.0-beta.1.

Cosa contiene lo stub di changelog generato?

Un blocco Markdown con la nuova versione, la data odierna e una sezione (Breaking Changes, Features o Bug Fixes) pronta da compilare con la descrizione della modifica.

Il comando git tag generato crea automaticamente il tag nel mio repository?

No, copia solo il comando da eseguire manualmente nel terminale: lo strumento è client-side e non ha accesso al tuo repository Git.

Cosa succede se inserisco una versione in un formato non valido?

Il tool mostra il messaggio "Formato non valido" e non calcola alcun risultato finché non correggi l'input con una versione SemVer valida.