Tema 5 · npm & npx CLI

5. Gestión de Dependencias: dependencies vs devDependencies, npm scripts y npx

Instala paquetes de producción y herramientas de desarrollo, automatiza flujos con "npm run" y ejecuta binarios remotos sin instalación global con npx.

Gestión Profesional de Paquetes con npm

npm (Node Package Manager) es el registro de software de código abierto más grande del mundo, con más de 2 millones de paquetes disponibles. Para mantener un proyecto limpio y seguro, es crítico clasificar adecuadamente cada librería.

dependencies vs devDependencies

1. dependencies (Producción)

Librerías indispensables para que la aplicación funcione en el servidor final (ej. Express, drivers de base de datos PostgreSQL/MySQL, JSON Web Tokens).

npm install express dotenv
2. devDependencies (Desarrollo)

Herramientas que solo usas mientras programas en tu computadora local (linters, suites de tests, compiladores, nodemon). No deben desplegarse en el VPS de producción.

npm install -D eslint nodemon

Automatización con npm Scripts

La sección scripts de package.json define atajos de línea de comandos. Permite ejecutar herramientas instaladas localmente en node_modules/.bin sin necesidad de agregarlas al PATH global del sistema operativo:

"scripts": {
  "start": "node src/server.js",        // Ejecutable con: npm start
  "dev": "node --watch src/server.js",  // Ejecutable con: npm run dev
  "test": "node --test",                // Ejecutable con: npm test
  "lint": "eslint ."                    // Ejecutable con: npm run lint
}

Nota útil: Los comandos estándar start y test no requieren escribir la palabra run; puedes ejecutarlos directamente como npm start.

El Comando npx (Node Package Execute)

Antes de npx, para usar generadores o utilidades CLI (como crear proyectos o inicializar configuraciones) los desarrolladores solían instalarlos globalmente con npm install -g, llenando el sistema de binarios desactualizados.

npx permite descargar temporalmente la versión más reciente de un paquete en la memoria caché, ejecutarlo y eliminarlo al terminar sin dejar basura en tu disco:

# Genera una plantilla de proyecto sin instalar nada previamente
npx create-next-app@latest mi-frontend

# Inicializa la configuración de Tailwind en el directorio actual
npx tailwindcss init -p

⚡ Comandos Clave de Gestión y Flujo de Trabajo en la Terminal

Guía de comandos cotidianos para instalar, auditar y ejecutar proyectos en Node.js:

terminal-workflow.sh
Solo lectura
# 1. Instalar dependencias de producción
npm install express pg bcryptjs

# 2. Instalar herramientas exclusivas de desarrollo (-D o --save-dev)
npm install -D supertest vitest

# 3. Desinstalar un paquete que ya no necesitas
npm uninstall moment

# 4. Auditoría de seguridad para detectar vulnerabilidades en dependencias
npm audit

# 5. Corrección automática de parches de vulnerabilidades seguras
npm audit fix

# 6. Ejecución de scripts definidos en package.json
npm run dev

# 7. Ejecución de binario CLI bajo demanda sin instalación global con npx
npx prisma init
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
¿Cuál es la diferencia fundamental entre el comando "npm install" y el comando "npx"?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar Node.js & npm Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.