Problemas con la instalación tradicional de Node.js

Node.js es una herramienta esencial en el desarrollo frontend. Si utiliza el método de instalación con paquetes binarios para instalar Node.js, con el tiempo enfrentará problemas directamente relacionados con: versiones de Node.js demasiado nuevas o demasiado antiguas.

• Al iniciar nuevos proyectos o adoptar tecnologías más recientes, algunas requieren Node.js >= 18 o incluso la última versión de Node.js. Por ejemplo:
• En proyectos heredados, las dependencias pueden rechazar versiones nuevas de Node.js, como en el siguiente caso:

Si recibe este mensaje de error que incluye: --legacy-peer-deps, indica que su versión de Node.js es demasiado reciente.

Puede intentar resolver temporalmente el problema agregando el flag --legacy-peer-deps a su comando de instalación:

npm install --legacy-peer-deps

• Esta solución es temporal y no resuelve conflictos subyacentes. En instalaciones futuras, podría necesitar nuevamente este parámetro.
• Para una solución permanente, considere:
  1. Actualizar sus dependencias para garantizar compatibilidad.
  2. Cambiar su versión de Node.js.

La versión de Node.js instalada con paquetes binarios claramente no es suficiente! Similar a tener una pareja que exige que tenga éxito profesional pero también disponga de tiempo libre

Por esta razón, los gestores de versiones de Node.js son la solución ideal. Aquí recomiendo usar nvm. nvm es un gestor de versiones de Node.js multiplataforma. Visite el sitio oficial de nvm para más información.

No instale Node.js, instale directamente nvm

Ventajas de usar nvm para instalar Node.js

• Instalación sencilla con un solo comando
• Cambio fluido entre versiones de Node.js
• Posibilidad de mantener múltiples versiones simultáneamente

Comenzando con NVM

• 1. Si ya tiene Node.js instalado mediante paquete binario, desinstálelo. En Windows, puede hacerlo a través del Panel de Control -> Programas y características.
• 2. Si no tiene ninguna versión de Node.js instalada, proceda directamente con la instalación de nvm.

【Instalación de nvm】 En sistemas Windows

Visite el repositorio de nvm-windows y haga clic en "Download Now!"

Luego, descargue nvm-setup.exe.

Instálelo en su sistema Windows.

nvm-setup.exe es el instalador de nvm para Windows. Al hacer doble clic en este archivo, se inicia el proceso de instalación. Durante la instalación, nvm-setup.exe copia los archivos necesarios al directorio de instalación y configura las variables de entorno, permitiendo el uso de comandos de nvm en cualquier terminal. Este método simplifica el proceso, eliminando la necesidad de configuración manual.

Después de la instalación, nvm estará disponible. Abra una nueva terminal y ejecute:

nvm -v

【Instalación de nvm】 En Linux y Mac

Ejecute el instalador de nvm en la terminal

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

# o alternativamente

wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

Puede usar curl o wget según los comandos disponibles en su sistema. Este comando clonará el repositorio de nvm en el directorio ~/.nvm de su sistema.

El proceso de instalación también agregará automáticamente la configuración de nvm a su archivo de configuración. Si usa zsh, será ~/.zshrc. Si usa bash, será ~/.bash_profile u otro archivo de configuración.

Si la configuración no se agrega automáticamente, puede añadirla manualmente:

> export NVM_DIR="$([ -z "${XDG_CONFIG_HOME-}" ] && printf %s "${HOME}/.nvm" || printf %s "${XDG_CONFIG_HOME}/nvm")"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

Después de actualizar el archivo de configuración, recargue los cambios:

source ~/.bashrc

Ahora nvm estará disponible. Verifique la instalación con:

nvm -v

Gestión de versiones con nvm

Una vez instalado nvm, puede instalar, desinstalar y cambiar entre versiones de Node.js en Windows, Linux o Mac. Ahora puede administrar fácilmente múltiples versiones de Node.js para diferentes proyectos que requieren versiones específicas. Por ejemplo:

• Instalación de versiones:

# Instalar la última versión de Node
nvm install latest

# Instalar una versión específica (X.Y.Z)
nvm install vX.Y.Z

# Usar una versión específica
nvm use vA.B.C

Comandos comunes de nvm

nvm off                     // Deshabilitar el gestor de versiones (sin desinstalar nada)
nvm on                      // Habilitar el gestor de versiones
nvm -v(-version)            // Verificar versión de nvm
nvm install <version>       // Instalar Node.js con la versión especificada
nvm uninstall <version>     // Desinstalar una versión específica
nvm list                    // Listar todas las versiones instaladas
nvm list available          // Listar versiones disponibles para instalación
nvm use <version>           // Cambiar a una versión específica
nvm current                 // Mostrar la versión actualmente en uso

Node.js incluye npm como gestor de paquetes. Sin embargo, a veces npm install puede ser lento, mientras que yarn funcoina más eficientemente. Además, yarn proporciona una interfaz más clara con barras de progreso durante la instalación.

Instalación de Yarn [Opcional]

npm y yarn son los dos gestores de paquetes más utilizados en desarrollo frontend. Aunque npm es más común, yarn es mi preferencia en proyectos nuevos debido a sus ventajas:

• Velocidad superior. Yarn almacena en caché cada paquete descargado, evitando descargas duplicadas. Además, utiliza descargas paralelas para maximizar el uso de recursos.
• Mayor seguridad. Antes de ejecutar código, Yarn verifica la integridad de cada paquete mediante algoritmos de comprobación.
• Mayor fiabilidad. Con su formato de archivo de bloqueo detallado y su algoritmo de instalación definido, Yarn garantiza consistencia entre diferentes sistemas.

Instalación de Yarn

El método recomendado para gestionar Yarn es mediante Corepack, un nuevo binario incluido con todas las versiones de Node.js a partir de la 16.10. Actúa como intermediario entre usted y Yarn, permitiendo usar diferentes versiones del gestor en varios proyectos sin necesidad de incluir el binario de Yarn en su repositorio.

Si usa Node.js >=16.10 con nvm, Corepack está incluido pero desactivado por defecto. Para habilitarlo:

corepack enable

Si usa Node.js < 16.10, puede instalar Yarn directamente con npm:

npm install yarn -g

Configuración de registros npm

Al instalar dependencias con npm o yarn, es recomendable especificar un registro (registry) para mejorar la velocidad de descarga, especialmente cuando el registro oficial es lento o se requieren soluciones regionales.

Verificar el registro actual de npm

npm get registry

Establecer registro npm globalmente

npm set registry https://registry.npmmirror.com/

Configurar registro para un proyecto específico

Puede especificar un registro para un proyecto concreto editando el archivo .npmrc en el directorio raíz del proyecto:

# .npmrc
registry=https://registry.npmmirror.com/

Uso temporal de un registro [Recomendado]

Para usar un registro específico solo en la instalación actual sin modificar la configuración global, utilice el parámetro --registry:

npm install <paquete> --registry=<url-del-registro>

# Ejemplo: instalar lodash usando temporalmente el registro de Taobao
npm install lodash --registry=https://registry.npmmirror.com/

Esto no afecta su configuración global y solo utiliza el registro especificado para la instalación actual.

Registros alternativos para usuarios en China

# Registro de Alibaba Cloud
https://npm.aliyun.com

# Registro de Tencent Cloud
http://mirrors.cloud.tencent.com/npm/

# Registro de Huawei
https://repo.huaweicloud.com/repository/npm/

# Registro de la Universidad de Ciencia y Tecnología de China
https://mirrors.ustc.edu.cn/npm/