Comandos de Desarrollador Node.js

# Gestión de paquetes
npm install                    # instalar todas las dependencias
npm install zod                # agregar una dependencia
npm install -D vitest          # agregar una dependencia de desarrollo
npm run dev                    # iniciar servidor de desarrollo
npm run build                  # compilación de producción
 
# Gestión de versiones de Node
nvm install 22                 # instalar Node 22
nvm use 22                     # cambiar a Node 22
node -v                        # verificar versión de Node
 
# Entorno
export PORT=3001               # establecer variable de entorno para esta sesión
cat .env.local                 # ver archivo de entorno
echo $NODE_ENV                 # verificar entorno actual
 
# Comprobaciones rápidas
npx tsc --noEmit               # type-check sin compilar
npx next lint                  # ejecutar linter
npx vitest run                 # ejecutar pruebas una vez

# Configurar un nuevo proyecto Next.js desde cero
npx create-next-app@latest my-app --typescript --tailwind --app --src-dir
cd my-app
npm install zustand zod react-hook-form @hookform/resolvers
npm install -D vitest @testing-library/react
npm run dev
# Aplicación ejecutándose en http://localhost:3000

# Instalar
npm install                        # instalar desde package.json
npm install --legacy-peer-deps     # resolver conflictos de dependencias pares
npm ci                             # instalación limpia (usa el lockfile exactamente, más rápido en CI)
 
# Agregar/eliminar paquetes
npm install lucide-react           # agregar dependencia
npm install -D prettier            # agregar dependencia de desarrollo
npm uninstall lodash               # eliminar un paquete
 
# Inspeccionar
npm list --depth=0                 # paquetes instalados de nivel superior
npm outdated                       # buscar actualizaciones
npm audit                          # vulnerabilidades de seguridad
npm audit fix                      # auto-corregir vulnerabilidades
 
# Scripts
npm run dev
npm run build
npm run start
npm test
npm run lint
 
# Ver un paquete antes de instalar
npm info zustand                   # detalles del paquete
npm info zustand versions          # todas las versiones publicadas
 
# Vincular un paquete local para desarrollo
cd ../my-library && npm link
cd ../my-app && npm link my-library

# Instalar pnpm
npm install -g pnpm
 
# Comandos equivalentes
pnpm install                       # instalar todo
pnpm add zod                       # agregar dependencia
pnpm add -D vitest                 # agregar dependencia de desarrollo
pnpm remove lodash                 # eliminar
pnpm dev                           # ejecutar script (sin "run" necesario)
pnpm build
 
# Comandos de workspace (monorepo)
pnpm -r build                     # ejecutar build en todos los paquetes
pnpm --filter @app/web dev        # ejecutar dev en paquete específico

# Instalar nvm (macOS/Linux)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
 
# Instalar y usar una versión de Node
nvm install 22
nvm install 20
nvm use 22
nvm alias default 22              # establecer predeterminado para nuevas terminales
 
# Usar versión del archivo .nvmrc
echo "22" > .nvmrc
nvm use                           # lee .nvmrc
 
# Listar versiones instaladas
nvm ls
 
# Listar versiones disponibles
nvm ls-remote | grep "Latest LTS"

# Establecer solo para comando actual
PORT=3001 npm run dev
NODE_ENV=production npm run build
 
# Establecer para sesión actual
export DATABASE_URL="postgresql://localhost:5432/mydb"
 
# Ver variables de entorno actuales
env | grep NODE
printenv PORT
 
# Estructura de archivo .env (Next.js)
# .env                - todos los entornos (confirmado)
# .env.local          - sobrescrituras locales (gitignored)
# .env.development    - solo desarrollo
# .env.production     - solo producción
# .env.test           - solo pruebas
 
# Acceder en Next.js
# Servidor: process.env.DATABASE_URL
# Cliente: process.env.NEXT_PUBLIC_API_URL (debe tener prefijo NEXT_PUBLIC_)
 
# Verificar qué variables de entorno ve tu aplicación
node -e "console.log(process.env.NODE_ENV)"

# Type-check sin compilar
npx tsc --noEmit
 
# Type-check en modo watch
npx tsc --noEmit --watch
 
# Generar archivos de declaración
npx tsc --declaration --emitDeclarationOnly
 
# Verificar tsconfig
npx tsc --showConfig
 
# Encontrar errores de tipo específicos
npx tsc --noEmit 2>&1 | grep "error TS"
 
# Contar errores de tipo
npx tsc --noEmit 2>&1 | grep "error TS" | wc -l
 
# Verificar un archivo específico
npx tsc --noEmit src/lib/utils.ts

# Compilación de producción de Next.js
npm run build
# Muestra tamaños de rutas, estático vs dinámico, desglose de bundle
 
# Analizar tamaño de bundle
npm install -D @next/bundle-analyzer
ANALYZE=true npm run build
 
# Verificar tamaño de paquete antes de instalar
npx package-size zustand zod lodash
# o usar https://bundlephobia.com
 
# Medir tiempo de compilación
time npm run build
 
# Verificar qué hay en node_modules
du -sh node_modules                    # tamaño total
du -sh node_modules/* | sort -rh | head -20  # paquetes más grandes
npx depcheck                           # encontrar dependencias no utilizadas

# Depurador de Node.js
node --inspect server.js               # adjuntar Chrome DevTools
node --inspect-brk server.js           # romper en primera línea
 
# Depurar una aplicación Next.js
NODE_OPTIONS='--inspect' npm run dev
 
# Perfil de memoria
node --max-old-space-size=4096 server.js   # aumentar heap a 4GB
node --heap-prof server.js                  # generar perfil de heap
 
# REPL rápido para pruebas
node
> const { z } = require('zod')
> z.string().email().safeParse('test@example.com')
 
# Ejecutar un one-liner
node -e "console.log(Date.now())"
node -e "console.log(require('./package.json').version)"
node -p "require('os').cpus().length"      # -p imprime el resultado
 
# Verificar resolución de módulos
node -e "console.log(require.resolve('react'))"

# Probar un endpoint de API
curl http://localhost:3000/api/health
curl -s http://localhost:3000/api/users | jq .
 
# POST con cuerpo JSON
curl -X POST http://localhost:3000/api/users \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice", "email": "alice@example.com"}'
 
# POST con encabezado de autenticación
curl -H "Authorization: Bearer $TOKEN" \
  http://localhost:3000/api/protected
 
# Tiempo de solicitud
curl -o /dev/null -s -w "Total: %{time_total}s\nTTFB: %{time_starttransfer}s\n" \
  http://localhost:3000
 
# Observar un puerto
lsof -i :3000                  # qué está usando puerto 3000
kill -9 $(lsof -ti :3000)      # matar lo que está en puerto 3000