Настройка Webpack для React требует понимания нескольких ключевых аспектов. Рассмотрим пошаговый процесс конфигурации.
Сначала установим необходимые пакеты:
npm install webpack webpack-cli webpack-dev-server --save-dev
npm install react react-dom
npm install @babel/core babel-loader @babel/preset-env @babel/preset-react --save-dev
Создаем файл webpack.config.js
:
const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
entry: './src/index.js', // Точка входа
output: {
path: path.resolve(__dirname, 'dist'),
filename: 'bundle.js',
clean: true, // Очищаем папку dist перед каждой сборкой
},
resolve: {
extensions: ['.js', '.jsx'], // Расширения файлов для резолва
},
module: {
rules: [
{
test: /\.(js|jsx)$/,
exclude: /node_modules/,
use: {
loader: 'babel-loader', // Используем babel для JS/JSX
},
},
{
test: /\.css$/,
use: ['style-loader', 'css-loader'], // Обработка CSS
},
{
test: /\.(png|svg|jpg|jpeg|gif)$/i,
type: 'asset/resource', // Обработка изображений
},
],
},
plugins: [
new HtmlWebpackPlugin({
template: './public/index.html', // Шаблон HTML
filename: 'index.html',
}),
],
devServer: {
static: {
directory: path.join(__dirname, 'dist'),
},
compress: true,
port: 3000,
open: true, // Автоматически открывать браузер
hot: true, // Включить Hot Module Replacement
},
};
Создаем файл .babelrc
:
{
"presets": [
"@babel/preset-env",
"@babel/preset-react"
]
}
Для обработки SCSS/SASS установим дополнительные лоадеры:
npm install sass-loader sass css-loader style-loader --save-dev
Добавляем правило в webpack.config.js
:
{
test: /\.s[ac]ss$/i,
use: [
'style-loader',
'css-loader',
'sass-loader',
],
}
Добавим отдельную конфигурацию для production:
const TerserPlugin = require('terser-webpack-plugin');
const CssMinimizerPlugin = require('css-minimizer-webpack-plugin');
module.exports = {
// ... остальная конфигурация
optimization: {
minimize: true,
minimizer: [
new TerserPlugin(), // Минификация JS
new CssMinimizerPlugin(), // Минификация CSS
],
splitChunks: {
chunks: 'all', // Разделение vendor кода
},
},
};
Используем dotenv-webpack
для работы с .env:
npm install dotenv-webpack --save-dev
Добавляем в конфиг:
const Dotenv = require('dotenv-webpack');
module.exports = {
plugins: [
new Dotenv()
]
}
Для TypeScript-проектов:
npm install typescript ts-loader @types/react @types/react-dom --save-dev
Добавляем правило:
{
test: /\.tsx?$/,
use: 'ts-loader',
exclude: /node_modules/,
}
И обновляем resolve.extensions
:
resolve: {
extensions: ['.js', '.jsx', '.ts', '.tsx'],
}
Дополнительные полезные плагины:
npm install webpack-bundle-analyzer clean-webpack-plugin --save-dev
Использование:
const { BundleAnalyzerPlugin } = require('webpack-bundle-analyzer');
const { CleanWebpackPlugin } = require('clean-webpack-plugin');
module.exports = {
plugins: [
new CleanWebpackPlugin(),
new BundleAnalyzerPlugin({
analyzerMode: 'static',
openAnalyzer: false,
}),
]
}
Для настройки Webpack под React необходимо:
Готовая конфигурация позволяет:
Пример полной конфигурации можно найти на официальном сайте Webpack или в репозиториях Create-React-App.