Para un proyecto que debe mantenerse, empieza por una versión de Node.js con soporte LTS y comprueba los requisitos del proyecto antes de cambiarla. El número más alto de la descarga no basta para decidir: una versión Alpha sirve para pruebas de novedades, no para asumir compatibilidad de tus dependencias.
Este ejercicio separa tres comprobaciones: soporte oficial de la rama, ejecutable que realmente se utiliza y resultado de tu programa. Terminarás con un pedido de dos líneas cuyo total puedes verificar a mano, sin instalar paquetes.
LTS, Alpha y fin de soporte: fotografía del 18 de noviembre de 2026
La tabla oficial de versiones de Node.js, consultada para esta guía, muestra las ramas 26, 24 y 22 como LTS, la 27 como Alpha y la 25 y 20 como EOL. Revisa esa tabla el día que instales: este texto no es un listado automático de parches disponibles. El proyecto recomienda ramas Active LTS o Maintenance LTS para producción.
| Situación | Decisión antes de cambiar |
|---|---|
| Proyecto nuevo sin restricción de dependencias | Seleccionar una rama LTS soportada y confirmar las versiones admitidas por el framework y el hosting. |
| Proyecto existente con una versión declarada | Reproducir primero esa versión y sus pruebas. Si está fuera de soporte, preparar una migración; no cambiarla a ciegas. |
| Tutorial que pide Alpha para una función nueva | Usar un entorno de prueba separado. No trasladar ese requisito automáticamente a producción. |
| Hosting que solo admite una rama concreta | Consultar su soporte y el del proyecto. Que la descarga exista no prueba compatibilidad del despliegue. |
La política histórica de versiones pares e impares también está cambiando a partir de Node 27. Por eso resulta más fiable leer el estado oficial que memorizar «par significa estable». La ficha es una guía de decisión, no una noticia de lanzamiento: no se afirma un anuncio ocurrido hoy.
1. Identifica el Node que ejecuta tu terminal
node --version
node -p "process.execPath"
node -p "JSON.stringify({version:process.version,lts:process.release.lts||null,plataforma:process.platform,arquitectura:process.arch})"
npm --version
Los comandos consultan el entorno; no instalan ni actualizan. La ruta de process.execPath permite detectar otra instalación o el ejecutable elegido por un gestor de versiones. Evita compartir rutas personales sin revisarlas.
El campo lts de process.release informa sobre la compilación que estás ejecutando. No consulta por sí mismo si la rama sigue soportada hoy. Una instalación antigua puede conservar una etiqueta LTS después de alcanzar EOL; cruza siempre las dos comprobaciones.
Si node no se reconoce, aún no has demostrado un fallo de JavaScript: la terminal no encuentra ese comando. Consulta las descargas oficiales o las instrucciones del gestor que ya utiliza tu proyecto. Esta práctica no necesita instalar otro gestor ni cambiar variables globales.
2. Revisa lo que pide el proyecto
Antes de ejecutar instalaciones, abre el README y, si existe, package.json como texto. Busca engines.node y archivos de versión indicados por el equipo. No supongas que todos los proyectos tienen estos campos.
Por ejemplo, "node": ">=24 <27" expresa un rango de versiones, no una orden de instalar la más nueva. La documentación de npm sobre engines explica que normalmente es informativo salvo políticas de comprobación adicionales. Un aviso EBADENGINE no se arregla ignorándolo sistemáticamente: compara el rango, la versión activa y las instrucciones del proyecto.
Un package.json puede contener scripts que ejecuten código. Lee el proyecto y confía en su procedencia antes de lanzar instalaciones o pruebas. Para el ejercicio de abajo no necesitas npm install, un archivo de bloqueo ni una conexión a un servicio.
3. Ejercicio: un pedido con total verificable
En una carpeta nueva guarda este archivo como pedido.cjs. La extensión fija CommonJS para que el ejemplo no dependa del campo type de otro proyecto. Usamos centavos enteros para poder comparar la suma exactamente.
const pedido = [
{ unidades: 3, precioCentavos: 12000 },
{ unidades: 2, precioCentavos: 7500 }
];
function totalCentavos(lineas) {
if (!Array.isArray(lineas)) throw new TypeError('Se esperaba una lista');
return lineas.reduce((total, linea) => {
if (linea === null || typeof linea !== 'object' ||
!Number.isSafeInteger(linea.unidades) || linea.unidades < 0 ||
!Number.isSafeInteger(linea.precioCentavos) || linea.precioCentavos < 0) {
throw new TypeError('Unidades y precio deben ser enteros no negativos');
}
const subtotal = linea.unidades * linea.precioCentavos;
const siguiente = total + subtotal;
if (!Number.isSafeInteger(subtotal) || !Number.isSafeInteger(siguiente)) {
throw new RangeError('Importe fuera del rango entero seguro');
}
return siguiente;
}, 0);
}
console.log('Node:', process.version);
console.log('LTS:', process.release.lts || 'sin etiqueta LTS');
console.log('Total en centavos:', totalCentavos(pedido));
module.exports = { totalCentavos };
Ejecuta node pedido.cjs. Las primeras dos líneas dependen de tu instalación; la tercera debe ser Total en centavos: 51000. La comprobación manual es 3 × 12,000 + 2 × 7,500 = 51,000 centavos, es decir, 510 unidades monetarias. No hay impuestos, descuentos ni conversión de divisas en este ejemplo.
Cambia una cantidad a cero: esa línea aporta cero. Una lista vacía suma cero. Una cantidad negativa, fraccionaria, un precio escrito como texto o un importe fuera del rango entero seguro debe provocar un error. Estos rechazos forman parte del ejercicio: no conviertas valores de entrada arbitrarios a número sin validarlos.
El ejemplo usa CommonJS y JavaScript básico; que pase no acredita que un framework, un complemento nativo o tu aplicación completa sea compatible con otra rama de Node. La guía oficial de ejecución de scripts explica la invocación desde la terminal.
4. Distingue el fallo de versión del fallo del programa
| Qué observas | Qué has demostrado |
|---|---|
| El comando no existe | La terminal no encuentra Node. Todavía no ejecutó el archivo. |
| Se imprime una versión distinta de la prevista | Debes revisar la selección del intérprete antes de comparar resultados. |
| El pedido da 51000, pero el proyecto real falla | El ejercicio funciona; no demuestra compatibilidad de las dependencias del proyecto. |
| Aparece un error por cantidad negativa | La validación rechaza la entrada como fue diseñada. No prueba un problema de LTS. |
| Una Alpha ejecuta el ejemplo | Esa compilación pasó esta prueba pequeña; no implica soporte para producción. |
Resultado de la prueba y siguiente paso
El código se ejecutó en macOS ARM64 con Node.js 22.22.0. Se comprobaron el total 51,000, lista vacía, cero, suma de varias líneas y rechazos por valores inválidos y desbordamiento entero. No se instaló ni se probó Node 26 o 27 para esta guía. La tabla de soporte procede de Node.js; las pruebas del programa pertenecen al entorno declarado.
Antes de adoptar otra rama, guarda el estado del proyecto, ejecuta sus pruebas existentes en un entorno separado y compara el comportamiento importante. No actualices un servidor para comprobar si desaparece un error local. Si necesitas contexto sobre el entorno, consulta la introducción a Node.js; esta ficha resuelve la elección de versión y su comprobación práctica.
Vigencia revisada: 18 de noviembre de 2026. La compatibilidad de dependencias y hosting debe verificarse en sus propias fuentes.