{"schema_version":"1.0","type":"Article","canonical_url":"https://visteesto.com/nota/que-es-semver-versionado-semantico","machine_urls":{"markdown":"https://visteesto.com/ai/article/que-es-semver-versionado-semantico/markdown","json":"https://visteesto.com/ai/article/que-es-semver-versionado-semantico/json"},"publisher":{"name":"VisteEsto","url":"https://visteesto.com","editor":"Martín Rodríguez","editorial_policy":"https://visteesto.com/politica-editorial","corrections_policy":"https://visteesto.com/correcciones"},"headline":"Qué es SemVer y cómo funciona el versionado semántico","description":"Qué es SemVer, qué significan las partes mayor, menor y parche de una versión y cómo comunicar cambios compatibles o que rompen una API.","dek":"SemVer ordena una versión como mayor.menor.parche para comunicar el impacto de un cambio. La regla ayuda a decidir si una actualización puede instalarse con seguridad o necesita revisar el código.","language":"es","section":"Tecnología","topic":"semver-versionado-software","tags":["Programación","Desarrollo","Software","Tecnología"],"author":{"name":"Martin Rodriguez","profile_url":"https://visteesto.com/autor/martin-rodriguez"},"date_published":"2026-09-24T21:00:00.000Z","date_modified":"2026-09-24T21:00:00.000Z","search_intent":"service","content_format":"service","primary_query":"qué es SemVer y cómo funciona","intended_audience":"Personas que desarrollan software y equipos que publican paquetes o mantienen integraciones con dependencias.","original_contribution":"VisteEsto traduce cada número de SemVer a una decisión práctica: aceptar una actualización, revisar cambios de API o preparar una migración.","key_facts":[{"statement":"SemVer usa tres números para comunicar cambios mayor, menor y parche en una API pública.","evidence_url":"https://semver.org/"},{"statement":"Un cambio incompatible aumenta la versión mayor, mientras una funcionalidad compatible aumenta la menor.","evidence_url":"https://semver.org/"},{"statement":"Los gestores de paquetes usan rangos de versiones para resolver dependencias según las reglas declaradas.","evidence_url":"https://docs.npmjs.com/about-semantic-versioning"},{"statement":"Una release reúne una versión del código y notas que ayudan a entender los cambios para quienes la instalan.","evidence_url":"https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases"}],"sections":[{"heading":"Qué es SemVer","paragraphs":["SemVer, abreviatura de Semantic Versioning, es una convención para numerar versiones de software con tres partes: mayor, menor y parche. Una versión como 2.4.1 comunica un orden y también una expectativa sobre el impacto de actualizarla.","La convención funciona cuando el proyecto define una API pública: funciones, comandos, formatos o comportamientos que otros clientes usan. Si no hay una interfaz que mantener, el número sigue siendo útil como etiqueta, pero pierde parte de la promesa de compatibilidad."]},{"heading":"Qué significa mayor, menor y parche","paragraphs":["El número mayor cambia cuando se introduce una modificación incompatible con la API pública. El número menor aumenta al sumar funcionalidad compatible y el número de parche cambia para correcciones compatibles. Cada parte se reinicia cuando cambia una de mayor impacto.","El orden también permite comparar versiones: 2.10.0 es posterior a 2.9.5 aunque el 9 parezca más grande al mirar los caracteres. El prefijo cero suele reservarse para una etapa inicial en la que todavía no se promete estabilidad completa."]},{"heading":"Cómo se relaciona con las dependencias","paragraphs":["Los gestores de paquetes pueden expresar rangos para aceptar actualizaciones compatibles. Un rango no significa que cualquier versión sea segura por definición: depende de que el proyecto respete SemVer y de que sus pruebas detecten cambios inesperados en la práctica.","Antes de actualizar una dependencia, revisá el changelog, el rango configurado y las pruebas del proyecto. Una versión mayor merece una lectura especial porque puede exigir cambios en el código; una versión menor o de parche también puede revelar un error corregido que conviene incorporar."]},{"heading":"Qué revisar antes de publicar una versión","paragraphs":["Definí la API pública y anotá si el cambio agrega, corrige o retira comportamiento. Después ejecutá las pruebas, actualizá el número correcto y escribí las notas de la versión con ejemplos de migración cuando una modificación rompa una integración.","La etiqueta de una release debe apuntar al código y a los artefactos que realmente se pueden instalar. Publicar una versión no reemplaza la revisión de seguridad ni las pruebas de compatibilidad, pero un número coherente permite que las herramientas y los equipos entiendan qué esperar."]}],"sources":[{"name":"Semantic Versioning 2.0.0","url":"https://semver.org/","kind":"primary"},{"name":"npm Docs: About semantic versioning","url":"https://docs.npmjs.com/about-semantic-versioning","kind":"primary"},{"name":"GitHub Docs: About releases","url":"https://docs.github.com/en/repositories/releasing-projects-on-github/about-releases","kind":"primary"}],"primary_source_gap":null,"images":[{"url":"https://visteesto.com/media/que-es-semver-versionado-semantico/cover.jpg","alt":"Versión mayor menor y parche representada en un paquete de software","width":1200,"height":675,"creator":"VisteEsto","license":"VisteEsto editorial","licenseUrl":"https://visteesto.com/terminos","sourceUrl":"https://visteesto.com/nota/que-es-semver-versionado-semantico","caption":"Ilustración editorial: mayor, menor y parche comunican el impacto esperado de una versión."},{"url":"https://visteesto.com/media/que-es-semver-versionado-semantico/inline-1.jpg","alt":"Comparación entre cambios mayor menor y parche de una versión","width":1200,"height":800,"creator":"VisteEsto","license":"VisteEsto editorial","licenseUrl":"https://visteesto.com/terminos","sourceUrl":"https://visteesto.com/nota/que-es-semver-versionado-semantico","caption":"Ilustración editorial: cada parte de la versión señala un tipo distinto de cambio."},{"url":"https://visteesto.com/media/que-es-semver-versionado-semantico/inline-2.jpg","alt":"Release de software con dependencias y notas de migración","width":1200,"height":675,"creator":"VisteEsto","license":"VisteEsto editorial","licenseUrl":"https://visteesto.com/terminos","sourceUrl":"https://visteesto.com/nota/que-es-semver-versionado-semantico","caption":"Ilustración editorial: una release reúne código, dependencias y notas para actualizar con contexto."}],"videos":[],"update_log":[{"date":"2026-09-24T21:00:00.000Z","note":"Publicación inicial basada en Semantic Versioning 2.0.0, la documentación de npm y GitHub Releases."}],"citation_guidance":{"preferred_url":"https://visteesto.com/nota/que-es-semver-versionado-semantico","include":["headline","author","date_published_or_modified","preferred_url"]}}