Cómo usar npm en Ubuntu: instalación, comandos básicos y guía de solución de problemas

1. Introducción

Por qué usar npm en Ubuntu

Una de las herramientas esenciales tanto para el desarrollo frontend como backend es npm (Node Package Manager). npm se usa ampliamente como el gestor de paquetes para Node.js, permitiendo a los desarrolladores instalar y administrar fácilmente bibliotecas y herramientas JavaScript.

Al usar npm en Ubuntu, puedes aprovechar el rendimiento ligero de Linux y la gestión flexible de paquetes, mejorando significativamente la eficiencia del desarrollo. Ubuntu es una distribución respaldada por una gran comunidad de desarrolladores y se utiliza ampliamente, desde operaciones de servidor hasta entornos de desarrollo locales.

En particular, al trabajar con frameworks basados en Node.js como Vue.js, React y Next.js, la gestión de paquetes con npm es el enfoque estándar. Configurar estas herramientas en Ubuntu te permite crear un entorno de desarrollo estable con menos problemas comparado con Windows o macOS.

Propósito de este artículo

Este artículo ofrece una guía paso a paso para instalar npm en Ubuntu y dominar su uso básico. Está pensado especialmente para los siguientes públicos:

• Desarrolladores que son nuevos en Ubuntu
• Personas que tienen dificultades con la configuración de Node.js o npm
• Cualquiera que quiera aprender npm de forma estructurada

Se presentan varios métodos de instalación, junto con sus características, ventajas y desventajas. Además, esta guía cubre errores comunes, consejos de solución de problemas y comandos útiles para ayudar a los lectores a usar npm sin inconvenientes en Ubuntu.

2. Instalación de Node.js y npm en Ubuntu

Para usar npm en Ubuntu, primero debes instalar Node.js. Dado que npm se incluye con Node.js, al instalar Node.js automáticamente tendrás npm disponible.

A continuación se describen tres métodos principales para instalar Node.js y npm en Ubuntu. Cada método tiene sus propias particularidades, por lo que es importante elegir el que mejor se adapte a tu estilo y objetivo de desarrollo.

Método 1: Usar el repositorio oficial de Ubuntu

Pasos

Node.js está disponible en los repositorios estándar de Ubuntu. Este es el enfoque más sencillo y amigable para principiantes.

sudo apt update
sudo apt install nodejs npm

Después de la instalación, puedes comprobar las versiones con los siguientes comandos:

node -v
npm -v

Ventajas

• Comandos simples y fáciles de entender
• Versiones estables provistas por Ubuntu

Desventajas

• Las versiones de Node.js y npm suelen estar desactualizadas, por lo que puede que no cuenten con las últimas funcionalidades

Método 2: Usar el PPA de NodeSource

Al utilizar el repositorio de NodeSource, que sigue de cerca el soporte oficial de Node.js, puedes instalar versiones más recientes de Node.js y npm.

Pasos (Ejemplo: Instalación de Node.js 18.x)

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

npm se instala automáticamente junto con Node.js.

Ventajas

• Acceso a versiones relativamente nuevas y estables
• Instalación sencilla con buena compatibilidad en Ubuntu

Desventajas

• Como ocurre con otros PPAs, puede ser necesario gestionar dependencias

Método 3: Usar nvm (Node Version Manager)

Si deseas cambiar entre múltiples versiones de Node.js, usar nvm es la opción más flexible y potente.

Pasos

Primero, instala nvm:

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

Luego recarga tu shell e instala Node.js usando nvm:

source ~/.bashrc  # or ~/.zshrc
nvm install 18
nvm use 18

npm se instala automáticamente junto con Node.js.

Ventajas

• Cambia libremente entre versiones de Node.js
• Define versiones apropiadas por proyecto
• Seguro, ya que no afecta al sistema globalmente

Desventajas

• Configuración ligeramente más compleja comparada con los otros métodos
• Requiere editar archivos de configuración del shell

¿Qué método deberías elegir?

En general, nvm es la opción más recomendada para el desarrollo a largo plazo de npm en Ubuntu. Sin embargo, si deseas una configuración rápida y simple, usar el PPA de NodeSource también es una elección sólida.

3. Uso básico de npm

Una vez que Node.js y npm estén instalados en Ubuntu, puedes comenzar a gestionar paquetes con npm. npm es una herramienta poderosa para instalar, actualizar y eliminar paquetes de JavaScript.

Esta sección introduce comandos comunes de npm y operaciones básicas.

Instalación de paquetes

Instalación local

Los paquetes que se usan solo dentro de un proyecto específico deben instalarse localmente. Esta es la aproximación estándar. Los paquetes se instalan en el directorio node_modules y se registran en package.json.

npm install package-name

Ejemplo: Instalando axios

npm install axios

Solo los scripts dentro del mismo proyecto pueden usar paquetes instalados localmente.

Instalación global

Las herramientas usadas a nivel de sistema, como utilidades de CLI, deben instalarse globalmente.

npm install -g package-name

Ejemplo: Instalando http-server globalmente

sudo npm install -g http-server

En Ubuntu, usar -g puede requerir sudo.

Desinstalación de paquetes

Eliminación de paquetes locales

npm uninstall package-name

Eliminación de paquetes globales

sudo npm uninstall -g package-name

Actualización de paquetes

Actualización de un paquete específico

npm update package-name

Actualización de todas las dependencias

npm update

Las actualizaciones se aplican dentro de los rangos de versión especificados en package.json, por lo que presta atención a las restricciones de versión.

Instalación de dependencias de desarrollo (–save-dev)

Los paquetes solo para desarrollo, como herramientas de prueba o compilación, deben instalarse usando la opción --save-dev.

npm install --save-dev package-name

Ejemplo: Instalando jest como dependencia de desarrollo

npm install --save-dev jest

Esto registra el paquete bajo devDependencies en package.json.

Listado de paquetes instalados

Listar paquetes locales

npm list

Listar paquetes globales

npm list -g --depth=0

Usar --depth=0 muestra solo paquetes de nivel superior, haciendo la salida más fácil de leer.

Gestión de dependencias con package.json

El archivo package.json es un componente central de los proyectos basados en npm. Registra nombres de paquetes, versiones, scripts y la configuración general del proyecto.

Puedes crearlo usando:

npm init

Para una configuración simplificada con valores predeterminados:

npm init -y

4. Problemas comunes y soluciones

Al usar npm en Ubuntu, puedes encontrar errores o comportamientos inesperados. Esta sección introduce problemas comunes y cómo resolverlos.

Errores de permisos

Síntoma

EACCES: permission denied

Causa

Esto ocurre cuando el usuario actual no tiene permiso de escritura para el directorio donde npm intenta instalar paquetes. En Ubuntu, escribir en directorios del sistema como /usr/lib/node_modules requiere sudo.

Solución

• Ejecutar con sudo :

  sudo npm install -g package-name
  

• O cambiar el directorio de instalación global a una ruta propiedad del usuario:

  mkdir ~/.npm-global
  npm config set prefix '~/.npm-global'
  

Agregar lo siguiente a ~/.bashrc o ~/.profile:

export PATH="$HOME/.npm-global/bin:$PATH"

Aplicar los cambios:

source ~/.bashrc

Comando npm no encontrado

Síntoma

command not found: npm

Causa

• La instalación de Node.js o npm falló
• La variable de entorno PATH no está configurada

Solución

Verificar la ruta:

which npm

Si no se devuelve nada, reinstala o verifica la configuración de PATH. Si usas nvm, asegúrate de que el código de inicialización exista en tu archivo de configuración del shell:

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

Fallos en la instalación de paquetes o conflictos de versión

Síntomas

• Conflictos de versiones al instalar un paquete
• Numerosas advertencias durante npm install

Soluciones

npm install package-name@latest

npm ls package-name

npm install --legacy-peer-deps

rm -rf node_modules package-lock.json
npm install

Comandos útiles de depuración

• npm doctor

  npm doctor
  

• npm audit

  npm audit
  npm audit fix
  

5. Preguntas frecuentes (FAQ)

P1. ¿Cómo puedo actualizar npm a la última versión en Ubuntu?

R1.

sudo npm install -g npm@latest

Si estás usando nvm, no se requiere sudo.

P2. ¿Cuál es la diferencia entre la instalación global y la local?

R2.

• Instalación local : Dependencias específicas del proyecto almacenadas en node_modules
• Instalación global : Herramientas de línea de comandos a nivel del sistema, a menudo requieren sudo

P3. ¿Cuáles son los beneficios de usar nvm?

R3.

nvm te permite cambiar entre múltiples versiones de Node.js de forma segura y eficiente, lo que lo hace ideal para el desarrollo de varios proyectos.

P4. ¿Qué debo hacer si las dependencias de npm se rompen?

R4.

rm -rf node_modules package-lock.json
npm install

P5. ¿Los mensajes npm WARN y audit son un problema?

R5.

Las advertencias no son fatales, pero indican posibles problemas. Para advertencias relacionadas con la seguridad, puedes intentar:

npm audit fix

P6. ¿Qué puedo crear con npm en Ubuntu?

R6.

• Frameworks de frontend (React, Vue, Svelte)
• Generadores de sitios estáticos (Next.js, Nuxt)
• Aplicaciones backend (Express, NestJS)
• Herramientas de línea de comandos
• Entornos de pruebas

6. Conclusión: Domina npm en Ubuntu

Este artículo cubrió los conceptos esenciales para instalar y usar npm en Ubuntu, desde la configuración hasta la solución de problemas.

El paso más importante es experimentar de forma práctica. Al ejecutar comandos y comprender los mensajes de error, profundizarás gradualmente tus habilidades como desarrollador.

Esto concluye la guía completa para usar npm en Ubuntu. Esperamos que te ayude a crear un entorno de desarrollo más eficiente y potente.