Quando você instala uma biblioteca e vê um número de versão como 2.4.1, esse número não é aleatório — ele segue uma convenção chamada versionamento semântico, que comunica o tipo de mudança feita naquela versão.
O que cada número significa
O formato é MAJOR.MINOR.PATCH. O primeiro número (MAJOR) muda quando há mudança que quebra compatibilidade. O segundo (MINOR) muda quando adiciona funcionalidade nova sem quebrar nada. O terceiro (PATCH) muda quando corrige um bug, sem adicionar nada novo.
Por que isso importa na prática
- Ajuda a decidir se é seguro atualizar uma dependência automaticamente
- Sinaliza quando uma atualização pode quebrar seu código existente
- Facilita entender o histórico de mudanças de um projeto
- Permite fixar versão compatível sem travar em uma única versão exata
Um exemplo prático
Se uma biblioteca vai de 2.4.1 para 2.4.2, é seguro assumir que foi só correção de bug. Se vai de 2.4.1 para 2.5.0, ganhou funcionalidade nova, mas continua compatível. Se vai de 2.4.1 para 3.0.0, algo mudou que pode quebrar o que você já tinha.
Erros comuns relacionados a isso
- Atualizar versão MAJOR sem ler o que mudou
- Ignorar completamente o número de versão ao escolher uma dependência
- Não entender por que o projeto quebrou depois de atualizar uma biblioteca