Actualizado en noviembre de 2026 para webpack 5.112. La primera versión de este artículo es de 2019: hemos corregido los ejemplos de código y añadido todo lo que ha cambiado desde entonces.
Webpack es un empaquetador de módulos (module bundler). Le das un fichero de entrada y sigue cada import y cada require que encuentra, apunten a JavaScript, CSS, imágenes o fuentes, hasta tener el grafo de dependencias completo de tu aplicación. Después convierte ese grafo en unos pocos ficheros que el navegador puede cargar: uno o varios paquetes de JavaScript, una hoja de estilos y los recursos, con nombres que cambian cuando cambia su contenido.
Además, sus plugins le permiten encargarse de casi cualquier tarea de compilación: minificar, generar la página HTML, inyectar variables de entorno, partir el código en trozos que se cargan cuando hacen falta… Por eso durante años sustituyó también a gestores de tareas como Grunt y Gulp.
Webpack sigue en la versión 5, que salió en octubre de 2020, pero no se ha quedado quieto. Las versiones de 2026 cambian bastante la forma de usarlo, y se sigue descargando unos 75 millones de veces a la semana desde npm.
Para ver de un vistazo lo que hace webpack, fíjate en este esquema:
A la izquierda, los módulos de un proyecto y las flechas entre ellos, que son las dependencias. A la derecha, lo que sale de webpack: una página HTML, un paquete de JavaScript con su mapa de código fuente, una hoja de estilos y los ficheros estáticos.
Conceptos de webpack
Cinco ideas cubren casi todo lo que vas a encontrar en un fichero de configuración:
- Entry (entrada). El módulo del que parte webpack para construir el grafo de dependencias. Desde ahí averigua de qué módulos y librerías depende y los va añadiendo hasta que no queda ninguno. Por defecto es
./src/index.js, pero puedes elegir otro fichero, varias entradas o, desde 2026, una página HTML. - Output (salida). Dónde escribe webpack los paquetes y cómo se llaman. Por defecto,
./dist/main.jspara el paquete principal y la carpeta./distpara todo lo demás. - Loaders (cargadores). De serie webpack entiende JavaScript, JSON y WebAssembly, y desde la versión 5.109 también CSS y HTML. Para todo lo demás (Sass, Less, PostCSS, plantillas…) hace falta un loader, que transforma el fichero en un módulo que webpack puede añadir al grafo. TypeScript funciona sin loader de forma experimental si webpack se ejecuta con Node.js 22.6 o posterior; si no, sigue haciendo falta ts-loader o babel-loader. Las imágenes y las fuentes ya no necesitan loaders: los asset modules (
asset/resource,asset/inlineyasset/source) ocuparon el lugar de file-loader, url-loader y raw-loader. - Plugins. Para lo que los loaders no pueden hacer: optimizar y minificar el paquete, gestionar los recursos, definir variables de entorno, generar manifiestos…
- Mode (modo).
development,productiononone. Cada uno activa las optimizaciones integradas de su entorno: código legible y recompilaciones rápidas en desarrollo, minificación y eliminación del código que no se usa en producción;nonelas desactiva todas. Si no lo indicas, webpack usaproductiony te avisa.
Para qué sirve un empaquetador
Una aplicación web está hecha de muchos módulos que dependen unos de otros. Un módulo de JavaScript importa otros módulos y usa imágenes JPG o PNG; hay ficheros CSS, quizá escritos con un preprocesador como Sass, Less o Stylus; y encima vienen decenas de paquetes de npm, cada uno con sus propias dependencias.
Webpack coge todos esos módulos y los convierte en recursos que el navegador entiende: JavaScript, CSS, imágenes, fuentes. Ese proceso de empaquetado es lo que hace realmente webpack.
Hoy los navegadores cargan módulos ES de forma nativa, así que un proyecto pequeño puede vivir sin empaquetador. En cuanto crece, el empaquetador vuelve a compensar: unos pocos ficheros en lugar de cientos de peticiones, el código que no se usa eliminado (tree shaking), ficheros minificados, nombres con un hash para que el navegador los guarde en caché durante meses y código partido en trozos que solo se descargan cuando hacen falta.
Sistemas de módulos
Durante años JavaScript no tuvo un sistema de módulos propio. En el navegador había que elegir una de varias convenciones, y cada una necesitaba su librería para convertir esos módulos en algo que el navegador pudiera ejecutar. Estas son las tres que todavía te vas a encontrar:
- AMD (Asynchronous Module Definition), el que usa RequireJS: los módulos y sus dependencias se cargan de forma asíncrona.
- CommonJS, el que usa Node.js desde el principio, con
requireymodule.exports. - Módulos ES (ESM), el estándar del lenguaje desde ES2015, con
importyexport. Todos los navegadores actuales y Node.js los admiten de forma nativa.
Así se define y se usa un módulo con AMD:
// En myModule.js
define('myModule', ['dep1', 'dep2'], (dep1, dep2) => {
return {
calc: (a, b) => a + b,
};
});
// En app.js
define('app', ['myModule'], (myModule) => {
console.log(myModule.calc(1, 2));
});
El módulo declara sus dependencias, que se cargan de forma asíncrona, y la función las recibe cuando están listas. Después app.js pide el módulo que se acaba de definir.
Lo mismo con CommonJS:
// En myModule.js
exports.calc = (a, b) => a + b;
// En app.js
const myModule = require('./myModule');
console.log(myModule.calc(1, 2));
Aquí el módulo exporta una función y app.js la carga con require, de forma síncrona. Y con módulos ES:
// En myModule.js
export const calc = (a, b) => a + b;
// En app.js
import { calc } from './myModule.js';
console.log(calc(1, 2));
Webpack entiende los tres y puede mezclarlos en el mismo proyecto: eso es lo que permite usar paquetes antiguos de npm escritos en CommonJS junto a tu propio código en ESM. Si empiezas algo hoy, escribe módulos ES. AMD es cosa del pasado, y CommonJS sobrevive sobre todo en los paquetes de Node.js.
Un proyecto mínimo en 2026
Necesitas Node.js 20.9 o posterior, que es lo que pide webpack-cli 7. Instala webpack y su herramienta de línea de comandos:
npm install --save-dev webpack webpack-cli
Crea src/myModule.js con la función calc del ejemplo anterior, un fichero src/styles.css con cualquier regla y src/index.js:
import './styles.css';
import { calc } from './myModule.js';
document.body.append(`1 + 2 = ${calc(1, 2)}`);
Ejecuta npx webpack. Sin una sola línea de configuración obtienes dist/main.js y, desde webpack 5.109, también dist/main.css, con los estilos extraídos y minificados. Hasta entonces eso exigía css-loader y mini-css-extract-plugin.
Cuando el proyecto crece, la configuración va en webpack.config.js:
const path = require('path');
module.exports = {
entry: './src/index.html',
output: {
path: path.resolve(__dirname, 'dist'),
filename: '[name].[contenthash].js',
htmlFilename: '[name].html',
clean: true,
},
module: {
rules: [
{ test: /\.(png|jpe?g|gif|svg|webp)$/i, type: 'asset/resource' },
],
},
};
La entrada es ahora src/index.html, una página normal que carga el script:
<!doctype html>
<html lang="es">
<head><title>Mi aplicación</title></head>
<body>
<script type="module" src="./index.js"></script>
</body>
</html>
Qué hace cada parte:
- Webpack lee la página HTML, empaqueta los scripts y los estilos que enlaza y escribe
dist/index.htmlcon los nombres definitivos. Antes eso era trabajo de html-webpack-plugin. [contenthash]solo cambia el nombre del fichero cuando cambia su contenido, así que el servidor puede decirle al navegador que lo guarde en caché mucho tiempo.clean: truevacíadistantes de cada compilación.- La regla de las imágenes es un asset module: ya puedes escribir
import logoUrl from './logo.png', la imagen acaba endistcon un nombre con hash ylogoUrlcontiene su URL. Sin esa regla, importar un PNG da un error de compilación.
Por último, dos scripts en package.json:
"scripts": {
"build": "webpack --mode production",
"dev": "webpack serve --mode development"
}
npm run build genera la versión de producción. npm run dev arranca el servidor de desarrollo, que recarga la página cada vez que guardas; es un paquete aparte (npm install --save-dev webpack-dev-server) y su versión 6 necesita Node.js 22.15 o posterior.
Qué ha cambiado en webpack
Webpack 5 llegó en octubre de 2020 con una caché persistente en disco (recompilaciones mucho más rápidas), los asset modules, un tree shaking mejor y Module Federation, que permite a aplicaciones desplegadas por separado compartir código en tiempo de ejecución y es la base de muchas arquitecturas de microfrontends.
Webpack 6 todavía no existe, pero 2026 ha traído cambios grandes dentro de la versión 5:
- CSS y HTML integrados (5.109). Importar una hoja de estilos o usar una página HTML como entrada no necesita configuración. El equipo de webpack ha declarado obsoletos css-loader, style-loader, mini-css-extract-plugin, html-loader y html-webpack-plugin en favor de este soporte integrado. Los proyectos que ya los usan siguen funcionando igual, y hay codemods para migrar.
- Target universal (5.108, experimental). Una sola compilación que funciona en el navegador, en los web workers y en Node.js, siempre como módulos ES. La misma versión añadió targets propios para Deno y Bun.
- Salida en módulos ES estable (5.111).
output.module: trueya no necesita la opciónexperiments.outputModule.
Webpack 6 está en la hoja de ruta oficial, como la versión en la que todo esto deja de ser experimental, pero todavía no tiene fecha.
¿Webpack u otra cosa?
Webpack ya no es la opción obvia para un proyecto nuevo. Así está el panorama a finales de 2026:
- Vite es donde empieza la mayoría de los proyectos nuevos, con casi cuatro veces las descargas semanales de webpack. Desde Vite 8 (marzo de 2026) usa Rolldown, un empaquetador escrito en Rust, tanto en desarrollo como en producción.
- Rspack, creado en ByteDance y escrito también en Rust, mantiene la API de webpack y sigue siendo compatible con su ecosistema. La versión 2.0 salió en abril de 2026. Es la salida habitual para los proyectos grandes de webpack que quieren compilar más rápido sin reescribir su configuración.
- Turbopack es el empaquetador por defecto de Next.js desde la versión 16 (octubre de 2025), y allí webpack sigue disponible con
next build --webpack. Por ahora solo funciona dentro de Next.js.
Aun así, webpack sigue mereciendo la pena: funciona en una cantidad enorme de proyectos existentes, nadie tiene un ecosistema de loaders y plugins como el suyo, Module Federation sigue siendo su punto fuerte y los conceptos de este artículo (entry, output, loaders, plugins, mode) son los mismos en Rspack y, con otros nombres, en Vite.
Fuentes
- Conceptos de webpack y asset modules, documentación oficial (en inglés)
- CSS and HTML Are Built In, blog de webpack, 16 de noviembre de 2026
- Notas de las versiones 5.108 y 5.111 de webpack
- Hoja de ruta de webpack para 2026
- Vite 8.0 is out!, Announcing Rspack 2.0 y Next.js 16