Aggiornato a novembre 2026 per webpack 5.112. La prima versione di questo articolo è del 2019: abbiamo corretto gli esempi di codice e aggiunto tutto quello che è cambiato da allora.
Webpack è un module bundler, cioè un impacchettatore di moduli. Gli dai un file di ingresso e lui segue ogni import e ogni require che trova, che puntino a JavaScript, CSS, immagini o font, finché non ha il grafo delle dipendenze completo della tua applicazione. Poi trasforma quel grafo in pochi file che il browser può caricare: uno o più bundle JavaScript, un foglio di stile e le risorse, con nomi che cambiano quando cambia il loro contenuto.
In più, grazie ai plugin può occuparsi di quasi qualsiasi compito di build: minificare, generare la pagina HTML, iniettare variabili d’ambiente, dividere il codice in pezzi che si caricano quando servono… Per questo per anni ha sostituito anche i task runner come Grunt e Gulp.
Webpack è ancora alla versione 5, uscita a ottobre 2020, ma non è rimasto fermo. Le release del 2026 cambiano parecchio il modo di usarlo, e viene ancora scaricato circa 75 milioni di volte a settimana da npm.
Per capire a colpo d’occhio cosa fa webpack, guarda questo schema:
A sinistra, i moduli di un progetto e le frecce tra di loro, che sono le dipendenze. A destra, quello che esce da webpack: una pagina HTML, un bundle JavaScript con la sua source map, un foglio di stile e i file statici.
I concetti di webpack
Cinque idee coprono quasi tutto quello che troverai in un file di configurazione:
- Entry (ingresso). Il modulo da cui webpack parte per costruire il grafo delle dipendenze. Da lì scopre da quali moduli e librerie dipende e li aggiunge finché non ne resta nessuno. Di default è
./src/index.js, ma puoi scegliere un altro file, più ingressi oppure, dal 2026, una pagina HTML. - Output (uscita). Dove webpack scrive i bundle e come si chiamano. Di default,
./dist/main.jsper il bundle principale e la cartella./distper tutto il resto. - Loader. Di serie webpack capisce JavaScript, JSON e WebAssembly, e dalla versione 5.109 anche CSS e HTML. Per tutto il resto (Sass, Less, PostCSS, template…) serve un loader, che trasforma il file in un modulo che webpack può aggiungere al grafo. TypeScript funziona senza loader in modo sperimentale se webpack gira su Node.js 22.6 o successivo; altrimenti servono ancora ts-loader o babel-loader. Immagini e font non hanno più bisogno di loader: gli asset module (
asset/resource,asset/inlineeasset/source) hanno preso il posto di file-loader, url-loader e raw-loader. - Plugin. Per quello che i loader non possono fare: ottimizzare e minificare il bundle, gestire le risorse, definire variabili d’ambiente, generare manifest…
- Mode (modalità).
development,productiononone. Ognuna attiva le ottimizzazioni integrate del suo ambiente: codice leggibile e ricompilazioni veloci in sviluppo, minificazione ed eliminazione del codice inutilizzato in produzione;nonele disattiva tutte. Se non la imposti, webpack usaproductione ti avvisa.
A cosa serve un bundler
Un’applicazione web è fatta di tanti moduli che dipendono l’uno dall’altro. Un modulo JavaScript importa altri moduli e usa immagini JPG o PNG; ci sono file CSS, magari scritti con un preprocessore come Sass, Less o Stylus; e in più arrivano decine di pacchetti npm, ognuno con le sue dipendenze.
Webpack prende tutti questi moduli e li trasforma in risorse che il browser capisce: JavaScript, CSS, immagini, font. Questo processo di impacchettamento è quello che webpack fa davvero.
Oggi i browser caricano i moduli ES in modo nativo, quindi un progetto piccolo può fare a meno del bundler. Appena cresce, il bundler torna a convenire: pochi file invece di centinaia di richieste, il codice inutilizzato eliminato (tree shaking), file minificati, nomi con un hash perché il browser li tenga in cache per mesi e codice diviso in pezzi che si scaricano solo quando servono.
I sistemi di moduli
Per anni JavaScript non ha avuto un sistema di moduli suo. Nel browser bisognava scegliere una tra varie convenzioni, e ognuna richiedeva la sua libreria per trasformare quei moduli in qualcosa che il browser potesse eseguire. Queste sono le tre che incontrerai ancora:
- AMD (Asynchronous Module Definition), quello usato da RequireJS: i moduli e le loro dipendenze si caricano in modo asincrono.
- CommonJS, quello che Node.js usa dall’inizio, con
requireemodule.exports. - Moduli ES (ESM), lo standard del linguaggio da ES2015, con
importedexport. Tutti i browser attuali e Node.js li supportano in modo nativo.
Ecco come si definisce e si usa un modulo con AMD:
// In myModule.js
define('myModule', ['dep1', 'dep2'], (dep1, dep2) => {
return {
calc: (a, b) => a + b,
};
});
// In app.js
define('app', ['myModule'], (myModule) => {
console.log(myModule.calc(1, 2));
});
Il modulo dichiara le sue dipendenze, che vengono caricate in modo asincrono, e la funzione le riceve quando sono pronte. Poi app.js chiede il modulo appena definito.
Lo stesso con CommonJS:
// In myModule.js
exports.calc = (a, b) => a + b;
// In app.js
const myModule = require('./myModule');
console.log(myModule.calc(1, 2));
Qui il modulo esporta una funzione e app.js la carica con require, in modo sincrono. E con i moduli ES:
// In myModule.js
export const calc = (a, b) => a + b;
// In app.js
import { calc } from './myModule.js';
console.log(calc(1, 2));
Webpack li capisce tutti e tre e può mescolarli nello stesso progetto: è questo che permette di usare vecchi pacchetti npm scritti in CommonJS accanto al tuo codice in ESM. Se inizi qualcosa oggi, scrivi moduli ES. AMD appartiene al passato, e CommonJS sopravvive soprattutto nei pacchetti di Node.js.
Un progetto minimo nel 2026
Serve Node.js 20.9 o successivo, che è quello che chiede webpack-cli 7. Installa webpack e il suo strumento da riga di comando:
npm install --save-dev webpack webpack-cli
Crea src/myModule.js con la funzione calc dell’esempio precedente, un file src/styles.css con una regola qualsiasi e src/index.js:
import './styles.css';
import { calc } from './myModule.js';
document.body.append(`1 + 2 = ${calc(1, 2)}`);
Lancia npx webpack. Senza una sola riga di configurazione ottieni dist/main.js e, da webpack 5.109, anche dist/main.css, con gli stili estratti e minificati. Fino ad allora servivano css-loader e mini-css-extract-plugin.
Quando il progetto cresce, la configurazione va in 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' },
],
},
};
L’ingresso adesso è src/index.html, una pagina normale che carica lo script:
<!doctype html>
<html lang="it">
<head><title>La mia app</title></head>
<body>
<script type="module" src="./index.js"></script>
</body>
</html>
Cosa fa ogni parte:
- Webpack legge la pagina HTML, impacchetta gli script e gli stili che collega e scrive
dist/index.htmlcon i nomi definitivi. Prima era il lavoro di html-webpack-plugin. [contenthash]cambia il nome del file solo quando cambia il suo contenuto, così il server può dire al browser di tenerlo in cache a lungo.clean: truesvuotadistprima di ogni build.- La regola delle immagini è un asset module: adesso puoi scrivere
import logoUrl from './logo.png', l’immagine finisce indistcon un nome con hash elogoUrlcontiene il suo URL. Senza quella regola, importare un PNG dà un errore di build.
Infine, due script nel package.json:
"scripts": {
"build": "webpack --mode production",
"dev": "webpack serve --mode development"
}
npm run build genera la versione di produzione. npm run dev avvia il server di sviluppo, che ricarica la pagina ogni volta che salvi; è un pacchetto a parte (npm install --save-dev webpack-dev-server) e la sua versione 6 richiede Node.js 22.15 o successivo.
Cosa è cambiato in webpack
Webpack 5 è arrivato a ottobre 2020 con una cache persistente su disco (ricompilazioni molto più veloci), gli asset module, un tree shaking migliore e la Module Federation, che permette ad applicazioni distribuite separatamente di condividere codice a runtime ed è la base di molte architetture a microfrontend.
Webpack 6 non esiste ancora, ma il 2026 ha portato grandi cambiamenti dentro la versione 5:
- CSS e HTML integrati (5.109). Importare un foglio di stile o usare una pagina HTML come ingresso non richiede configurazione. Il team di webpack ha deprecato css-loader, style-loader, mini-css-extract-plugin, html-loader e html-webpack-plugin a favore di questo supporto integrato. I progetti che già li usano continuano a funzionare così come sono, e ci sono dei codemod per migrare.
- Target universale (5.108, sperimentale). Una sola build che funziona nel browser, nei web worker e in Node.js, sempre come moduli ES. La stessa release ha aggiunto target specifici per Deno e Bun.
- Output in moduli ES stabile (5.111).
output.module: truenon ha più bisogno dell’opzioneexperiments.outputModule.
Webpack 6 è nella roadmap ufficiale, come la versione in cui tutto questo smetterà di essere sperimentale, ma non ha ancora una data.
Webpack o qualcos’altro?
Webpack non è più la scelta ovvia per un progetto nuovo. Ecco com’è la situazione a fine 2026:
- Vite è il punto di partenza della maggior parte dei progetti nuovi, con quasi quattro volte i download settimanali di webpack. Da Vite 8 (marzo 2026) usa Rolldown, un bundler scritto in Rust, sia in sviluppo sia in produzione.
- Rspack, nato in ByteDance e scritto anche lui in Rust, mantiene l’API di webpack e resta compatibile con il suo ecosistema. La versione 2.0 è uscita ad aprile 2026. È la via d’uscita più comune per i grandi progetti webpack che vogliono build più veloci senza riscrivere la configurazione.
- Turbopack è il bundler predefinito di Next.js dalla versione 16 (ottobre 2025), e lì webpack resta disponibile con
next build --webpack. Per ora funziona solo dentro Next.js.
Detto questo, webpack vale ancora la pena di conoscerlo: gira in un numero enorme di progetti esistenti, nessuno ha un ecosistema di loader e plugin come il suo, la Module Federation resta il suo punto di forza e i concetti di questo articolo (entry, output, loader, plugin, mode) sono gli stessi in Rspack e, con altri nomi, in Vite.
Fonti
- I concetti di webpack e gli asset module, documentazione ufficiale (in inglese)
- CSS and HTML Are Built In, blog di webpack, 16 novembre 2026
- Note di rilascio di webpack 5.108 e 5.111
- Roadmap 2026 di webpack
- Vite 8.0 is out!, Announcing Rspack 2.0 e Next.js 16