一、Webpack 是什么
Webpack 是一款现代 JavaScript 应用程序的静态模块打包工具。在 Web 开发中,我们的项目会包含各种类型的文件,如 JavaScript、CSS、图片等。Webpack 可以将这些文件打包成一个或多个文件,以便在浏览器中高效加载。它就像是一个超级管家,把项目中的各种资源整理打包,让它们能更好地协同工作。
二、为什么要使用 Webpack
- 代码拆分:可以将代码拆分成多个块,实现按需加载,提高页面加载速度。比如一个大型项目,有些功能可能不是用户一开始就需要的,Webpack 可以把这些功能代码单独打包,等用户用到时再加载。
- 模块加载:支持各种模块加载方式,如 ES6 模块、CommonJS 模块等,统一管理项目中的模块依赖。
- 处理不同类型文件:不仅能处理 JavaScript,还能处理 CSS、Sass、Less 等样式文件,以及图片、字体等资源文件。
三、Webpack 基础入门
(一)安装 Webpack
- 首先确保你已经安装了 Node.js,因为 Webpack 是基于 Node.js 运行的。
- 全局安装 Webpack 和 Webpack - CLI(命令行界面):
npm install webpack webpack - cli -g
(二)创建项目结构
- 创建一个新的文件夹,例如webpack - demo。
- 在该文件夹下创建以下文件和文件夹:
- src文件夹:用于存放源文件,在src文件夹下创建index.js文件。
- dist文件夹:用于存放打包后的文件,这个文件夹一开始可以不存在,Webpack 会在打包时自动生成。
(三)编写基础代码
在src/index.js中编写如下代码:
function add(a, b) {return a + b;
}
const result = add(1, 2);
console.log(result);
(四)配置 Webpack
在项目根目录下创建webpack.config.js文件,内容如下:
const path = require('path');
module.exports = {entry: './src/index.js',output: {filename: 'bundle.js',path: path.resolve(__dirname, 'dist')}
};
这里配置了入口文件entry为src/index.js,表示从这个文件开始打包;output指定了打包后的文件名filename为bundle.js,输出路径path为dist文件夹。
(五)执行打包
在命令行中进入项目根目录,执行以下命令:
webpack - - config webpack.config.js
执行成功后,会在dist文件夹下生成bundle.js文件。这个文件就是打包后的文件,包含了src/index.js中的代码以及相关依赖。
四、Webpack 核心功能
(一)加载器(Loaders)
- 作用:Webpack 本身只能处理 JavaScript 和 JSON 文件,Loaders 可以让 Webpack 处理其他类型的文件,如 CSS、图片等。
- 使用示例 - 加载 CSS 文件:
- 安装css - loader和style - loader:
npm install css - loader style - loader --save - dev
- 在src文件夹下创建styles.css文件,添加一些简单的样式:
body {background - color: lightblue;
}
- 修改src/index.js文件,引入styles.css:
import './styles.css';
function add(a, b) {return a + b;
}
const result = add(1, 2);
console.log(result);
- 修改webpack.config.js文件,配置加载器:
const path = require('path');
module.exports = {entry: './src/index.js',output: {filename: 'bundle.js',path: path.resolve(__dirname, 'dist')},module: {rules: [{test: /\.css$/,use: ['style - loader', 'css - loader']}]}
};
这里module.rules配置了一个规则,test表示匹配所有.css文件,use指定了使用style - loader和css - loader来处理这些文件。css - loader负责解析 CSS 文件,style - loader负责将解析后的 CSS 插入到 HTML 页面中。
(二)插件(Plugins)
- 作用:插件可以扩展 Webpack 的功能,实现更复杂的任务,如代码压缩、生成 HTML 文件、提取 CSS 为单独文件等。
- 使用示例 - 使用 HtmlWebpackPlugin 生成 HTML 文件:
- 安装html - webpack - plugin:
npm install html - webpack - plugin --save - dev
- 修改webpack.config.js文件,添加插件配置:
const path = require('path');
const HtmlWebpackPlugin = require('html - webpack - plugin');
module.exports = {entry: './src/index.js',output: {filename: 'bundle.js',path: path.resolve(__dirname, 'dist')},module: {rules: [{test: /\.css$/,use: ['style - loader', 'css - loader']}]},plugins: [new HtmlWebpackPlugin({title: 'Webpack Demo',template: './src/index.html'})]
};
这里引入了HtmlWebpackPlugin插件,配置了title为页面标题,template指定了使用src/index.html作为模板来生成 HTML 文件。在src文件夹下创建index.html文件:
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF - 8"><title><%= htmlWebpackPlugin.options.title %></title>
</head>
<body><script src="bundle.js"></script>
</body>
</html>
再次执行打包命令,会在dist文件夹下生成一个 HTML 文件,并且自动引入了打包后的bundle.js文件。
- 常用插件补充
- TerserPlugin:用于压缩 JavaScript 代码,减小文件体积,提升加载速度。它是 Webpack 4 + 版本默认的代码压缩插件,无需额外安装。在webpack.config.js中配置如下:
const path = require('path');
const HtmlWebpackPlugin = require('html - webpack - plugin');
const TerserPlugin = require('terser - webpack - plugin');
module.exports = {entry: './src/index.js',output: {filename: 'bundle.js',path: path.resolve(__dirname, 'dist')},module: {rules: [{test: /\.css$/,use: ['style - loader', 'css - loader']}]},plugins: [new HtmlWebpackPlugin({title: 'Webpack Demo',template: './src/index.html'})],optimization: {minimizer: [new TerserPlugin()]}
};
- MiniCssExtractPlugin:将 CSS 从 JavaScript 文件中提取出来,生成单独的 CSS 文件。这在生产环境中很有用,因为浏览器可以单独缓存 CSS 文件。安装命令:
npm install mini - css - extract - plugin --save - dev
在webpack.config.js中配置如下:
const path = require('path');
const HtmlWebpackPlugin = require('html - webpack - plugin');
const MiniCssExtractPlugin = require('mini - css - extract - plugin');
module.exports = {entry: './src/index.js',output: {filename: 'bundle.js',path: path.resolve(__dirname, 'dist')},module: {rules: [{test: /\.css$/,use: [MiniCssExtractPlugin.loader, 'css - loader']}]},plugins: [new HtmlWebpackPlugin({title: 'Webpack Demo',template: './src/index.html'}),new MiniCssExtractPlugin({filename:'styles.css'})]
};
- CleanWebpackPlugin:在每次打包前清空输出目录,避免残留旧文件。安装命令:
npm install clean - webpack - plugin --save - dev
在webpack.config.js中配置如下:
const path = require('path');
const HtmlWebpackPlugin = require('html - webpack - plugin');
const MiniCssExtractPlugin = require('mini - css - extract - plugin');
const { CleanWebpackPlugin } = require('clean - webpack - plugin');
module.exports = {entry: './src/index.js',output: {filename: 'bundle.js',path: path.resolve(__dirname, 'dist')},module: {rules: [{test: /\.css$/,use: [MiniCssExtractPlugin.loader, 'css - loader']}]},plugins: [new HtmlWebpackPlugin({title: 'Webpack Demo',template: './src/index.html'}),new MiniCssExtractPlugin({filename:'styles.css'}),new CleanWebpackPlugin()]
};
(三)代码拆分与按需加载配置
- 原理:Webpack 的代码拆分是指将一个大的 JavaScript 文件拆分成多个小的文件,这些小文件可以在需要的时候再加载。按需加载就是在特定的时机(比如用户点击某个按钮、访问某个路由等)才加载对应的代码块,而不是在页面一开始就加载所有代码,从而提高页面的初始加载速度和用户体验。
- 基础配置:在 Webpack 4 + 版本中,可以使用splitChunks配置项来实现代码拆分。在webpack.config.js中添加如下配置:
const path = require('path');
const HtmlWebpackPlugin = require('html - webpack - plugin');
module.exports = {entry: './src/index.js',output: {filename: 'bundle.js',path: path.resolve(__dirname, 'dist'),// 为动态导入的代码块指定输出路径和文件名chunkFilename: '[name].[chunkhash].js'},module: {rules: [{test: /\.css$/,use: ['style - loader', 'css - loader']}]},plugins: [new HtmlWebpackPlugin({title: 'Webpack Demo',template: './src/index.html'})],optimization: {splitChunks: {chunks: 'all'}}
};
optimization.splitChunks.chunks: 'all’表示对所有类型的 chunk(入口 chunk、异步 chunk 等)都进行代码拆分。这里output.chunkFilename用于指定非入口 chunk(动态导入的代码块)的输出文件名,[name]会被替换为代码块的名称,[chunkhash]会根据代码块内容生成哈希值,用于缓存控制。
- 实际应用示例 - 动态导入模块实现按需加载:
- 在src文件夹下创建一个新的文件math.js,编写如下代码:
export function multiply(a, b) {return a * b;
}
- 修改src/index.js文件,通过动态导入的方式引入math.js模块:
import './styles.css';
function add(a, b) {return a + b;
}
const result = add(1, 2);
console.log(result);
// 点击按钮时动态导入math.js模块并调用multiply函数
document.addEventListener('DOMContentLoaded', function () {const button = document.createElement('button');button.textContent = '点击计算乘法';document.body.appendChild(button);button.addEventListener('click', function () {import('./math.js').then((module) => {const product = module.multiply(3, 4);console.log('乘法结果:', product);});});
});
这里使用import(‘./math.js’)动态导入math.js模块,这是 ES2020 引入的动态导入语法,Webpack 会自动将其拆分成一个单独的代码块。当用户点击按钮时,才会加载这个代码块,实现了按需加载。执行打包命令后,在dist文件夹下会生成除了bundle.js之外的math.[chunkhash].js文件,这就是拆分出来的代码块。
五、总结
通过以上步骤,我们对 Webpack 的基础和核心功能有了初步了解。Webpack 还有很多高级特性,如代码优化、热模块替换等,后续可以进一步深入学习。希望这篇文章能帮助大家顺利入门 Webpack,开启高效的 Web 开发之旅。