Cómo habilitar y usar npm (Node.js Package Manager) en ServBay

npm (Node Package Manager) es la herramienta oficial de gestión de paquetes para Node.js y uno de los repositorios de software open source más grandes del mundo. Para los desarrolladores de Node.js, npm es una herramienta indispensable que facilita la instalación, el intercambio y la administración de las dependencias de código en tus proyectos. Gracias al entorno integrado que ofrece ServBay, puedes empezar a trabajar con npm de manera rápida y sencilla.

Requisitos previos

Antes de utilizar npm, necesitas instalar Node.js en ServBay.

1. Abre la aplicación de ServBay.
2. Navega hasta el panel de “Paquetes” (Packages).
3. Busca el paquete de Node.js y asegúrate de que está instalado y en ejecución.

ServBay configurará automáticamente el entorno de Node.js, que ya incluye npm.

Verifica que npm está instalado y disponible

La versión de Node.js que instala ServBay incluye npm de forma predeterminada y está habilitada. Puedes comprobar rápidamente que npm está correctamente instalado y accesible mediante la terminal.

1. Abre tu aplicación de terminal (por ejemplo, Terminal en macOS).

2. Escribe el siguiente comando para ver el número de versión de npm:

   npm -v

   Si el comando se ejecuta correctamente y ves el número de versión (por ejemplo, 10.2.0 o superior), significa que npm está correctamente instalado y disponible en el entorno actual.

   # Ejemplo de salida
   10.2.0

   Si ves un error como “command not found: npm”, asegúrate de haber instalado el paquete de Node.js a través de ServBay y que las variables de entorno de ServBay estén correctamente configuradas (normalmente, reiniciar la terminal o el ordenador soluciona problemas de variables de entorno).

Actualizar npm

Aunque la versión de Node.js instalada por ServBay normalmente incluye una versión estable de npm, este último se actualiza frecuentemente de forma independiente. Para acceder a las últimas funciones y correcciones, puedes actualizar npm usando el propio gestor:

npm install -g npm@latest

Este comando instala la última versión de npm de forma global. El flag -g indica que es una instalación global, de modo que podrás usar la nueva versión de npm desde cualquier ubicación.

Una vez actualizado, ejecuta de nuevo npm -v para confirmar la versión instalada:

npm -v

Funciones principales y usos comunes de npm

La fortaleza de npm reside en su enorme ecosistema open source y en su gestión eficiente de dependencias. Estos son algunos de los escenarios y comandos más habituales en el desarrollo cotidiano con npm:

Inicializar un nuevo proyecto Node.js

Cuando comienzas un nuevo proyecto Node.js en un directorio vacío, puedes usar el comando npm init para crear el archivo package.json. Este archivo es esencial para el proyecto: almacena metadatos del mismo, información de dependencias y los scripts ejecutables, entre otros detalles.

cd /Applications/ServBay/www/my-new-project.servbay.demo
npm init

npm init te guiará para completar información como el nombre, la versión, la descripción, el archivo principal del proyecto, etc. Si quieres generar rápidamente un package.json con valores por defecto, usa npm init -y.

Instalar dependencias del proyecto

En el directorio raíz del proyecto (donde se encuentra el archivo package.json), puedes instalar todas las dependencias necesarias usando:

cd /Applications/ServBay/www/my-project.servbay.demo
npm install

Este comando lee los campos dependencies y devDependencies de tu package.json, descargando y almacenando los módulos requeridos en el directorio node_modules del proyecto.

Añadir nuevas dependencias

Cuando tu proyecto necesita incorporar una nueva librería o framework, puedes instalarla usando:

# Instalar una dependencia de producción, por ejemplo, el framework Express
npm install express

# Instalar una dependencia de desarrollo, como Mocha para testing
npm install mocha --save-dev

Por defecto, npm install <nombre-del-paquete> instala el paquete en el directorio node_modules del proyecto y se añade al campo dependencies en el archivo package.json. Si utilizas el flag --save-dev, se añade en su lugar al campo devDependencies, indicado para herramientas de desarrollo, testing o construcción.

Eliminar dependencias

Si ya no necesitas un paquete, puedes eliminarlo con el comando:

npm uninstall express

Esto elimina el paquete de node_modules y actualiza tu archivo package.json.

Actualizar dependencias del proyecto

Para asegurarte de que todas las dependencias de tu proyecto están en su versión más reciente compatible (según lo especificado en package.json), ejecuta:

npm update

Este comando revisa los paquetes ya instalados en node_modules y los actualiza a la última versión dentro del rango especificado en tu archivo package.json.

Uso de scripts de npm

El campo scripts en package.json permite definir comandos personalizados para la terminal. Esta función es ideal para automatizar tareas repetitivas como iniciar servidores de desarrollo, ejecutar test, compilar proyectos, y más.

Por ejemplo, puedes agregar los siguientes scripts en tu package.json:

{
  "name": "my-project",
  "version": "1.0.0",
  "scripts": {
    "start": "node index.js",
    "test": "mocha test/**/*.js",
    "build": "webpack --config webpack.config.js"
  },
  "dependencies": {
    "express": "^4.18.2"
  },
  "devDependencies": {
    "mocha": "^10.2.0",
    "webpack": "^5.89.0"
  }
}

A continuación, puedes ejecutar estos scripts en la terminal con el comando npm run <nombre-del-script>:

# Iniciar la aplicación
npm start

# Ejecutar tests
npm test

# Realizar build
npm run build

Nota: para los scripts con nombre start, test, install, restart, stop y unos pocos más, puedes omitir run y simplemente usar npm start, npm test, etc.

Tabla rápida de comandos npm comunes

Además de los usos esenciales mencionados arriba, aquí tienes otros comandos útiles de npm:

• Instalar un paquete globalmente: Útil para herramientas de línea de comandos que quieras disponibles desde cualquier ubicación.

  npm install -g <nombre-del-paquete>
  # Por ejemplo, instalar npx (usualmente viene con Node.js)
  npm install -g npx
  # O instalar nodemon, una herramienta que reinicia tu app automáticamente durante el desarrollo
  npm install -g nodemon

• Ejecutar comandos temporales (npx): npx viene de serie desde npm v5.2+ y te permite ejecutar archivos binarios de la carpeta node_modules/.bin o ejecutar paquetes directamente y de manera temporal sin necesidad de instalarlos globalmente.

  # Crear una nueva app React sin instalar create-react-app globalmente
  npx create-react-app my-react-app

• Ver paquetes instalados globalmente: Para listar todos los paquetes globales y sus versiones.

  npm list -g --depth=0

• Limpiar la caché de npm: Si tienes errores al instalar paquetes, limpiar la caché puede ayudar a solucionarlos.

  npm cache clean --force

• Ver información de un paquete: Puedes consultar detalles, versiones, dependencias, repositorios, etc.

  npm view <nombre-del-paquete>

• Buscar paquetes: Busca paquetes en el repositorio de npm.

  npm search <palabra-clave>

Resolución de problemas

• npm command not found: Asegúrate de haber instalado el paquete de Node.js mediante ServBay y que tu terminal tiene acceso a las rutas de Node.js y npm. Normalmente, reiniciar la terminal o el ordenador soluciona el problema.
• Error al instalar dependencias: Verifica tu conexión a internet. Configuraciones de proxy en empresas pueden afectar npm; podrías necesitar configurar el proxy de npm. También puedes intentar limpiar la caché con npm cache clean --force y volver a intentar.
• Problemas de permisos: En macOS, a veces la instalación global (npm install -g) arroja problemas de permisos. Se recomienda utilizar Node Version Manager (nvm) o asegurarte de que ServBay esté bien configurado para los paths de instalación. Evita usar sudo para instalar de forma global, ya que puede provocar problemas más complejos. El Node.js que instala ServBay normalmente ya está ajustado para evitar inconvenientes de permisos y te permite trabajar en el directorio de instalación de ServBay sin problemas.

Conclusión

Gracias a ServBay puedes disfrutar de un entorno de desarrollo Node.js completo y listo para usar en tu equipo local, sacando el máximo provecho de la potente herramienta que es npm para la gestión de paquetes y el desarrollo de proyectos. Dominar los comandos y usos básicos de npm multiplicará tu productividad. A medida que profundices en el ecosistema de Node.js, descubrirás que npm se convertirá en tu compañero infaltable.