Gestor de Paquetes Bun: Guía Completa vs NPM, Yarn y PNPM

Bun es un runtime de JavaScript y gestor de paquetes construido desde cero con Zig y JavaScriptCore. Su objetivo es ser un reemplazo directo de NPM, Yarn y PNPM, con tiempos de instalación significativamente más rápidos y una toolchain más simple. Desde que este artículo se publicó por primera vez en febrero de 2024, Bun ha ganado soporte completo para Windows, un nuevo lockfile basado en texto, y fue adquirido por Anthropic en diciembre de 2025.

Por qué cambiar a Bun: comparativa de bun vs npm, yarn y pnpm

El argumento principal para cambiar es la velocidad. Bun instala paquetes en paralelo usando múltiples hilos, cachea los resultados globalmente y puede ser hasta 30 veces más rápido que npm en instalaciones en frío. En instalaciones en caliente (con la caché poblada y el lockfile presente), la diferencia es aún mayor.

Pero la velocidad no es la única razón. Esto es lo que obtienes:

Comparativa de velocidad: npm vs pnpm vs Bun

Los propios benchmarks de Bun afirman instalaciones “hasta 30 veces más rápidas” que npm. Ese número viene de su marketing, no de una fuente independiente. En la práctica, la diferencia depende del tamaño de tu proyecto, la red y el estado de la caché.

La página pnpm.io/benchmarks (actualizada a diario) compara npm, pnpm, Yarn Classic y Yarn PnP, pero no incluye Bun. Para npm vs pnpm, el benchmark muestra que pnpm es aproximadamente 2-3 veces más rápido que npm en instalaciones limpias. La ventaja real de Bun sobre npm suele ser de 5-15 veces, dependiendo del escenario.

Tus resultados variarán. Prueba en tu propio proyecto. Mira el benchmark real de más abajo como un punto de datos.

Cuando este artículo se publicó por primera vez, algunos desarrolladores cuestionaban la viabilidad a largo plazo de Bun, trazando paralelismos con el auge y caída de Yarn. La adquisición por Anthropic en diciembre de 2025 ha zanjado en gran parte ese debate. Bun ya no es un proyecto secundario. Es el runtime detrás de Claude Code.

Puedes consultar cómo migrar Astro a Bun en Cloudflare para ver un recorrido de migración real.

Cómo instalar Bun en macOS, Linux y Windows

Bun se instala en todas las plataformas principales. Abajo están los métodos recomendados actualmente.

brew install oven-sh/bun/bun

curl -fsSL https://bun.sh/install | bash

powershell -c "irm bun.sh/install.ps1 | iex"

npm install -g bun

Verificar la instalación

bun --version
# Debería mostrar algo como: 1.3.14

bun --revision
# Muestra la revisión del build (útil para reportar bugs)

Para autoactualizar Bun:

bun upgrade

Si bun no se encuentra tras la instalación, asegúrate de que ~/.bun/bin está en tu PATH. Añade esto a la configuración de tu shell:

# bash/zsh, añade a ~/.bashrc o ~/.zshrc
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

Para Fish shell, mira los mejores plugins y herramientas de Fish shell como guía para configurar el PATH.

Si necesitas Node.js instalado junto a Bun, mira cómo instalar Node.js usando NVM.

El lockfile de Bun: bun.lock vs bun.lockb

Antes de Bun 1.2 (enero de 2025), el lockfile predeterminado era el binario bun.lockb. Funcionaba, pero no podías hacerle diff en git, no podías revisar los cambios del lockfile en los PR, y los conflictos de merge eran imposibles de resolver a mano.

Bun 1.2 convirtió bun.lock en el predeterminado. Es un archivo JSONC basado en texto que genera diffs y merges como cualquier otro archivo fuente.

bun install --save-text-lockfile --frozen-lockfile --lockfile-only
# Luego elimina el viejo lockfile binario
rm bun.lockb

Verifica: ls bun.lock debería existir. Ejecuta git diff bun.lock. Deberías ver una salida JSONC legible.

Si bun install sigue generando bun.lockb en lugar de bun.lock, revisa bunfig.toml en busca de saveTextLockfile = false o actualiza tu versión de Bun.

Cómo migrar de NPM, Yarn o PNPM a Bun

Desde Bun 1.1, bun install puede migrar automáticamente desde lockfiles existentes. Pero el enfoque más limpio sigue siendo eliminar primero el lockfile viejo y luego dejar que Bun genere un bun.lock nuevo.

rm package-lock.json
bun install

rm yarn.lock
bun install

rm pnpm-lock.yaml
bun install

Verifica: ls bun.lock debería existir, ls node_modules debería mostrar los paquetes instalados, y bun run build (o el comando de build de tu proyecto) debería completarse con éxito.

Si tienes problemas con addons nativos, revisa bun pm untrusted. Bun bloquea los scripts de ciclo de vida (postinstall, etc.) por defecto desde Bun 1.1. Mira la sección de solución de problemas de abajo para saber cómo confiar en paquetes.

Para un recorrido completo de migración de Astro, mira migrar Astro a Bun en Cloudflare.

Referencia de comandos de Bun: comandos esenciales y equivalentes de npm

Comandos principales

Comprobar paquetes desactualizados

bun outdated
# Muestra todos los paquetes desactualizados con versión actual y última

bun outdated --filter '@myorg/*'
# Filtrar a un scope específico

Actualizar paquetes

bun update <package>            # Actualizar dentro del rango semver
bun update <package> --latest   # Actualizar a la última, ignorando semver
bun update                      # Actualizar todas las deps dentro del rango semver
bun update --interactive        # Elegir qué deps actualizar interactivamente

Para profundizar en la actualización de paquetes con Bun, mira cómo actualizar paquetes Node con Bun y cómo actualizar todas las dependencias de Node.js.

Seguridad y confianza

bun pm untrusted          # Listar paquetes con scripts de ciclo de vida bloqueados
bun pm trust <package>    # Confiar en un paquete específico
bun pm trust --all        # Confiar en todos los paquetes (usar con precaución)

Benchmark real: prueba de velocidad de bun install

Ejecuté esta prueba en el blog de Astro de bitdoze.com. El proyecto tiene una mezcla típica de dependencias. Aquí están los números en bruto:

NPM:

➜  bitdoze-astro-bkw git:(main) time npm install

npm install  13.22s user 3.82s system 23% cpu 1:13.89 total

npm run build  55.96s user 3.41s system 126% cpu 46.776 total

Bun:

➜  bitdoze-astro-bkw git:(main) time bun install

bun install  10.83s user 2.14s system 121% cpu 10.694 total

bun run build  55.30s user 3.34s system 126% cpu 46.181 total

Resultados: bun install tardó ~11 segundos. npm install tardó 73 segundos. Eso es 7 veces más rápido para este proyecto. El proceso de build fue idéntico. El mismo build de Astro corre a la misma velocidad sin importar qué gestor de paquetes instaló las dependencias.

Esto se probó en febrero de 2024 y se reverificó en julio de 2026. Bun 1.2+ es aproximadamente un 30 % más rápido que la versión probada originalmente, así que la diferencia probablemente se ha ampliado en instalaciones nuevas. Para ver cómo Astro 7 mejoró las velocidades de build, mira benchmark de Astro 7: tiempos de compilación reducidos a la mitad. También puedes optimizar aún más las velocidades de build de Astro con ajustes específicos de SSG.

Tus resultados variarán según el tamaño del proyecto, el número de dependencias, el hardware y las condiciones de red.

Bun en Docker y CI/CD: mejores prácticas de producción

Ejemplo de Dockerfile

Bun ofrece imágenes Docker oficiales. Usa oven/bun:alpine para la etapa de build (más pequeña, basada en musl) y oven/bun:distroless para el runtime (superficie de ataque mínima):

FROM oven/bun:alpine AS builder
WORKDIR /app
COPY package.json bun.lock ./
RUN bun install --frozen-lockfile

FROM oven/bun:distroless AS runtime
WORKDIR /app
COPY --from=builder /app/node_modules ./node_modules
COPY . .
EXPOSE 3000
CMD ["bun", "run", "start"]

Para omitir las devDependencies en producción:

bun install --frozen-lockfile --production

CI/CD con GitHub Actions

# .github/workflows/ci.yml
name: CI
on: [push, pull_request]
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: oven-sh/setup-bun@v2
        with:
          bun-version: latest
      - run: bun install --frozen-lockfile
      - run: bun run build
      - run: bun test

Fallo común: si --frozen-lockfile falla, significa que tu bun.lock no coincide con package.json. Ejecuta bun install localmente, commitea el lockfile y haz push.

Para más comandos y patrones de Docker, mira los comandos de Docker que debes conocer.

Ejemplos de uso de Bun

Añadir y eliminar paquetes

# Añadir paquetes
bun add tailwindcss autoprefixer postcss

# Añadir una dependencia de desarrollo
bun add prettier --dev

# Eliminar un paquete
bun remove tailwindcss

Ejecutar scripts

bun run dev      # Ejecutar el script "dev" de package.json
bun run build    # Ejecutar el script "build"
bun run test     # Ejecutar el script "test"

Para monorepos con workspaces, ejecuta scripts en paquetes específicos:

bun run --filter @myorg/web build

Comprobar y actualizar dependencias

# Ver qué está desactualizado
bun outdated

# Actualizar interactivamente (Bun 1.3+)
bun update --interactive

# Actualizar un paquete específico a la última versión
bun update tailwindcss --latest

Auditar vulnerabilidades

bun audit
# Busca vulnerabilidades de seguridad conocidas en las dependencias

Solución de problemas comunes de Bun

curl -fsSL https://bun.sh/install | bash -s -- --baseline

powershell -c "irm bun.sh/install.ps1 -- --baseline | iex"

# bash (~/.bashrc) o zsh (~/.zshrc)
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

set --export BUN_INSTALL "$HOME/.bun"
set --export PATH "$BUN_INSTALL/bin" $PATH

bun pm untrusted          # Ver qué paquetes están bloqueados
bun pm trust <package>    # Confiar en un paquete específico
bun pm trust --all        # Confiar en todos (usar con precaución)

{
  "trustedDependencies": ["package-name"]
}

uname -r

[install.scopes]
"@myorg" = { url = "https://registry.myorg.com", token = "npm_..." }

//registry.myorg.com/:_authToken=npm_...
@myorg:registry=https://registry.myorg.com

rm -rf node_modules bun.lock
npm install

Preguntas frecuentes

Conclusión

Bun como gestor de paquetes está listo para producción y es significativamente más rápido que npm, yarn o pnpm en tiempos de instalación. El bun.lock basado en texto, el soporte completo de Windows y el respaldo de Anthropic han resuelto las principales preocupaciones de cuando este artículo se publicó por primera vez.

Mi recomendación: prueba Bun como gestor de paquetes en tu próximo proyecto. Elimina el lockfile viejo, ejecuta bun install y mira qué tal se siente. Siempre puedes volver atrás si algo se rompe.

El lado del runtime (reemplazar Node.js) es una decisión aparte con más matices. ¿Pero para bun install vs npm install? No hay competencia.