import Update from "/es/snippets/cli/update.mdx";

NOTE

Para actualizar tu versión de Bun CLI, ver [`bun upgrade`](/es/runtime/installation#upgrading).

Para actualizar todas las dependencias a las últimas versiones:

bun update

Para actualizar una dependencia específica a la última versión:

bun update [package]

--interactive

Para una experiencia de actualización más controlada, usa la bandera --interactive para seleccionar qué paquetes actualizar:

bun update --interactive
bun update -i

Esto lanza una interfaz de terminal interactiva que muestra todos los paquetes desactualizados con sus versiones actuales y objetivo. Luego puedes seleccionar qué paquetes actualizar.

Interfaz interactiva

La interfaz muestra paquetes agrupados por tipo de dependencia:

? Select packages to update - Space to toggle, Enter to confirm, a to select all, n to select none, i to invert, l to toggle latest

  dependencies                Current  Target   Latest
    □ react                   17.0.2   18.2.0   18.3.1
    □ lodash                  4.17.20  4.17.21  4.17.21

  devDependencies             Current  Target   Latest
    □ typescript              4.8.0    5.0.0    5.3.3
    □ @types/node             16.11.7  18.0.0   20.11.5

  optionalDependencies        Current  Target   Latest
    □ some-optional-package   1.0.0    1.1.0    1.2.0

Secciones:

• Los paquetes se agrupan bajo encabezados de sección: dependencies, devDependencies, peerDependencies, optionalDependencies
• Cada sección muestra encabezados de columna alineados con los datos del paquete

Columnas:

• Package: Nombre del paquete (puede tener sufijo como dev, peer, optional para claridad)
• Current: Versión actualmente instalada
• Target: Versión que se instalaría (respeta restricciones semver)
• Latest: Última versión disponible

Controles de teclado

Selección:

• Space: Alternar selección de paquete
• Enter: Confirmar selecciones y actualizar
• a/A: Seleccionar todos los paquetes
• n/N: No seleccionar ninguno
• i/I: Invertir selección

Navegación:

• ↑/↓ Teclas de flecha o j/k: Mover cursor
• l/L: Alternar entre versión objetivo y última versión para el paquete actual

Salir:

• Ctrl+C o Ctrl+D: Cancelar sin actualizar

Indicadores visuales

• ☑ Paquetes seleccionados (serán actualizados)
• □ Paquetes no seleccionados
• > Posición actual del cursor
• Colores: Rojo (mayor), amarillo (menor), verde (parche) cambios de versión
• Subrayado: Objetivo de actualización actualmente seleccionado

Agrupación de paquetes

Los paquetes se organizan en secciones por tipo de dependencia:

• dependencies - Dependencias de runtime regulares
• devDependencies - Dependencias de desarrollo
• peerDependencies - Dependencias peer
• optionalDependencies - Dependencias opcionales

Dentro de cada sección, los paquetes individuales pueden tener sufijos adicionales ( dev, peer, optional) para claridad adicional.

--recursive

Usa la bandera --recursive con --interactive para actualizar dependencias a través de todos los espacios de trabajo en un monorepo:

bun update --interactive --recursive
bun update -i -r

Esto muestra una columna "Workspace" adicional mostrando a qué espacio de trabajo pertenece cada dependencia.

--latest

Por defecto, bun update actualizará a la última versión de una dependencia que satisface el rango de versión especificado en tu package.json.

Para actualizar a la última versión, sin importar si es compatible con el rango de versión actual, usa la bandera --latest:

bun update --latest

En modo interactivo, puedes alternar paquetes individuales entre su versión objetivo (respetando semver) y la última versión usando la tecla l.

Por ejemplo, con el siguiente package.json:

{
  "dependencies": {
    "react": "^17.0.2"
  }
}

• bun update actualizaría a una versión que coincide con 17.x.
• bun update --latest actualizaría a una versión que coincide con 18.x o posterior.