|
一、webpack简介
webpack 是当下十分流行的一款静态模块打包工具,将JS、CSS、HTML、图片等各种静态资源视为一个个模块,通过一个或者多个入口文件通过解析依赖关系生成一个依赖图,最终打包成一个或者多个bundles,webpack本身只能打包JS文件,但是通过配置的loader和plugin可以打包Css和Html等其他格式的文件,本文基于webpack5为基础的,其中webpack4前后版本区别很大,使用时需要注意区别版本。
webpack和glup、grunt的区别:webpack可以说是一种模块化解决方案,内嵌服务支持项目独立开发,同时可以打包单页面、多页面和提取公共模块以及处理图片文件。只打包被引用的文件,同时搭配强大的loader和plugin支持打包不同类型的语言,傻瓜式配置即可使用;grunt和glup则是基于任务式的打包工具,主要是用于编译CSS和JS,主要是用来合并、压缩和拷贝文件,不支持模块化打包。
二、配置详解
常用配置概览- module.exports = {
- // 模式,webpack针对不同模式设置内部优化项,设置后会自动调起优化项
- mode: 'development',
- // 入口 可以配置为相对路径或者绝对路径
- entry: './src/index.js',
- // 输出文件名称和路径,
- // path.reslove()返回一个绝对路径,__dirname当前文件的文件夹绝对路径
- output: {
- path: path.resolve(__dirname, 'dist'),
- // 打包输出文件名
- filename: 'main.js',
- // chunkFilename 指未被列在 entry 中,却又需要被打包出来的 chunk 文件的名称。一般来说,这个 chunk 文件指的就是要懒加载的代码
- chunkFilename: '[id].js',
- // 下次打包时将上次打包目录下的资源清空
- clean: true
- },
- // 加载器
- module: {
- rules: [],
- },
- // 插件
- pulgins: [],
- // 模式
- mode: 'development',
- //
- devtool: '',
- // 设置webpack如何解析模块,如别名、扩展名等
- resolve: {
- // 模块的后缀名,引入这些模块时不需要写扩展名,自动补充扩展名
- extensions: ['.js', '.json', '.css']
- },
- // 本地服务配置
- devServer: {
- // 指定端口
- port: 8000,
- // 是否开启模块热交换功能
- hot: true,
- // 是否自动在浏览器打开网页
- open: true
- },
- // 打包时排除编译该文件
- externals: {
- jquery: 'JQuery'
- },
- // 打包代码优化,进行公共代码提取,代码压缩,去除冗余代码等功能
- optimization: {
- splitChunks: {
- chunks: 'all',
- // 打包文件大于30kb时会被分割
- minSize: 30 * 1024,
- // 最大没有限制
- maxSize: 0,
- // 要提取的chunk最少被引用1次
- minChunks: 1,
- cacheGroups: {
- // node_modules下的文件会被打包到wendors中
- vendors: {
- test: /[\\/]node_modules[\\/]/,
- name: 'vendors',
- // 优先级
- priority: -10
- },
- // 提取公共组件
- commons: {
- name: 'chunk-commons',
- test: resolve('src/components'),
- minChunks: 3,
- priority:10
- }
- }
- }
- }
- }
复制代码
1. entry:打包入口,webpack打包从此处开始,通过解析依赖加载来构建依赖关系图,包含格式有包含格式有:string | [string] | object { : string | [string] } | (function: () => string | [string] | object { : string | [string] }),可以配置:- // 单入口单模块
- entry: './index.js',
- // 多入口单模块(多个入口一个出口)
- entry: ['./src/Component1/main.js', './src/Component2/main.js'],
- // 多入口
- entry:{ com1: './src/Component1/main.js', './src/Component1/main.js' },
- // 接受通过函数方式返回配置
- entry: glob.sync('./src/**/main.js').reduce((acc, path) => {
- const entry = path.substring(path.indexOf('/src/') + 5, path.lastIndexOf('/main.js'));
- acc[entry] = path; return acc;
- }, {}),
复制代码 2. output:打包文件输出配置,支持设置entry对应的name、id、hash、contenthash,需要注意filename和chunkFilename的区别- filename: "[name].[id].[contenthash].[hash:7].js",
复制代码 3. mode:模式,内嵌development和production以及none三种模式,针对开发和生产两种场景内置不同的优化项,比如压缩、去除冗余代码等
4. module:模块化配置,由于webpack只能解析JS,所以针对CSS、TS、SASS等无法解析的类型需要通过配置不同的loader进行处理编译。
4.1 style-loader: 将编译完成的CSS样式挂载到style标签上,实际使用中一般放在第一位,因为loader都是从右到左,从下往上执行- // 解析CSS
- rules: [{
- test: /\.css/,
- use: ['style-loader']
- }]
复制代码 4.2 css-loader:识别.css文件,处理CSS一般需要配合style-loader使用,否则样式不会生效,或者安装MiniCssExtractPlugin将文件单独打包- rules: [{
- test: /\.css$/,
- // use: ['style-loader', 'css-loader'],
- use: [MiniCssExtractPlugin.loader, 'css-loader'],
- // 可以排除对应文件夹的内容按照该rule进行打包
- exclude: /node_modules/<br>}]
复制代码 4.3 sass-loader处理.sass类型样式文件、postcss-loader用于补充CSS样式在各个浏览器内核的前缀,不需要手动写- // 打包SASS
- rules: [{
- test: /\.scss$/,
- use: [
- 'style-loader', 'css-loader', 'sass-loader', 'postcss-loader',
- ],
- include: '/sc/'
- }]
复制代码 4.4 bable-loader: 将ES6+语法转换为ES5语法。需要配合@bable/core 和bable/preset-env来使用- // 打包JS
- rules: [{
- test: /\.js$/,
- use: {
- loader: 'bable-loader',
- options: {
- presets: [[ 'bable/preset-env', { targets: 'defaults' } ]]
- }
- }
- }]
复制代码 4.5 html-loader:将 HTML 导出为字符串。当编译器需要时,将压缩 HTML 字符串。
4.6 file-loader:处理文件资源,比如jpg、png等图片- // 处理图片资源
- rules: [{
- test: /\.(png|jpg|jpeg)$/,
- use:[
- {
- loader: 'file-loader',
- options: {
- name: '[name]_[hash:8].[ext]'
- }
- }
- ]
- }]
复制代码 4.7 url-loader:同样是处理图片资源,与file-loader不同的是可以根据tip的大小决定是否将图片生成Base64保存到JS文件里,方便快速加载- // 处理图片资源
- rules: [{
- test: /\.(png|jpg|jpeg)$/,
- use:[
- {
- loader: 'url-loader',
- options: {
- name: '[name]_[hash:8].[ext]',<br> // 当小于10kb时转换为base64打包到JS当中,否则保存为图片<br> limit: 10240
- }
- }
- ]
- }]
复制代码 4.8 其余还有vue-loader 加载和解析vue文件;eslint-loader 通过eslint检查JS代码;i18n-loader 加载多语言版本,支持国际化。
注:官方loader查看地址 https://webpack.js.org/loaders/
5. plugins: 插件,和loader一样是webpack的支柱功能,主要解决loader无法解决的问题,需要使用某个插件时,首先需要安装,其次引入文件到本地中,最后才能使用
5.1 clean-webpack-plugin:打包前清理dist目录下的内容,避免再次打包时文件覆盖,之前的老文件遗留下来
5.2 copy-webpack-plugin:拷贝某个目录下的文件到dist下的某个目录,- new CopyWebpackPlugin([
- // 将src目录下的内容拷贝到dist/common下
- { from: './src', to: './common' }
- ])
复制代码 5.3 html-webpack-plugin:生成html文件,以及自动引入打包好的css文件和JS文件(由于打包后的JS和CSS为了避免缓存都会动态生成文件名,所以每次打包手动引入比较麻烦)- // 单页面打包
- new HtmlWebpackPlugin({ template: './index.html' }),
- // 多页面打包
- entry: {
- com1: './src/Component1/main.js',
- com2: './src/Component2/main.js'
- },
- plugins: [
- new HtmlWebpackPlugin({
- // 使用模板
- template: path.join(__dirname, 'src/component1/index.html'),
- // 打包后的文件名
- filename: 'com1.html',
- // 和入口文件的key值相对应
- chunks: ['com1']
- }),
- new HtmlWebpackPlugin({
- template: path.join(__dirname, 'src/component2/index.html'),
- filename: 'com2.html',
- chunks: ['com2']
- })
- ],
复制代码
5.4 mini-css-extract-plugin:打包好的样式一般通过style-loader会插入大页面中,但是如果想要实现CSS分离生成单独的文件,可以通过这个组件实现,但是需要配合前文中的loader使用- rules: [{
- test: /\.css$/,
- use: [MiniCssExtractPlugin.loader, 'css-loader']
- }],
- plugins: [
- new HtmlWebpackPlugin({ template: './index.html' }),
- new MiniCssExtractPlugin({
- filename: 'css/[name].css'
- })
- ],
复制代码 5.5 自定义组件AddAuthorPlugin开发和使用:- // 在plugin文件夹下新增一个add-author-plugin.js文件
- // 其中apply是内置方法
- class AddAuthorPlugin {
- constructor(options = {}) {
- this.author = options.author;
- this.date = options.date;
- }
- apply(compiler) {
- compiler.hooks.compile.tap('AddAuthorPlugin', (compilation, callback) => {
- console.log('***');
- })
- }
- }
- module.exports = AddAuthorPlugin;<br><br>// 使用的时候<br>const AddAuthorPlugin = require('./plugin/add-author-plugin');<br><br>new AddAuthorPlugin({ author: '张三', date: new Date() });
复制代码 打包时如何调测自定义组件:
首先执行命令 node --inspect-brk .\node_modules\webpack-cli\bin\cli.js,然后在chrome浏览器中输入 chrome://inspect/#devices 回车后,点击 Open dedicated DevTools for Node 就可以进入调测模式,为了方便打断点,可以现在代码中设置debugger。详细步骤看录屏
注:官方plugin查看地址 https://webpack.js.org/plugins/
6. devtool:已不同的方式打包文件,配置项总共有十几种,为了区分开发环境和生产环境,主要介绍下面几种
6.1 开发环境推荐使用:
eval:每个模块都使用eval执行,速度非常快,但是不会显示正确的行号,所以没法进行调试
eval-source-map:,每个模式使用eval()执行,起初是缓慢的,但是重建的速度较快而且产生真是的文件,行号也被正确映射,产生的开发资源也是最优的。
cheap-eval-source-map:每个模块也是经过eval执行,但是只映射了行号没有列,只显示与eval类似的被转换的代码。
6.2 生产环境推荐使用:
none:不触发sourcemap,性能最佳
source-map:会生成一个完整的sourceMap作为一个单独的文件,为bundle添加了引用注释,因此开发工作知道如何找到它。
hidden-source-map:与source-map类似,但不添加引用注释。
7. devServer:方便前后端分离开发,一个本地服务
8. optimization:打包优化,可以实现提取公共代码,代码压缩以及去除冗余代码等功能
三、常见问题
1. chunk和bundle的概念:chunk是一个代码块,在构建的时候会根据入口文件和依赖关系生成多个chunk,bundle是指最后生成的文件,包含所有的chunk和模块
2. vue中的webpack是如何使用的:当前通过vue-cli脚手架创建的Vue项目都内置了webpack的打包功能,基本不需要独立配置即可使用,如果更改配置项则需要在vue.config.js中配置- // 两种方式自定义webpack配置
- configureWebpack: {
- rules: [],
- plugins: []
- },
- configureWebpack: (config) => {
- config.devtool = 'source-map';
- config.plugins.push(***);
- }
复制代码 3. webpack的优缺点和其他组件(Vite)的对比:
优点:模块化打包、零配置
缺点:随着项目变大,模块化增多,启动时会逐渐变慢,热更新也会变慢
Vite:由于打包原理和底层开发使用的语言不同,总体Vite打包和启动都要比webpack快很多,但是Vite生态不完善。
来源:https://www.cnblogs.com/codeOnMar/p/17460562.html
免责声明:由于采集信息均来自互联网,如果侵犯了您的权益,请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容,谢谢合作! |
本帖子中包含更多资源
您需要 登录 才可以下载或查看,没有账号?立即注册
x
|