还学不会webpack?看这篇!
摘要: webpack入门教程。
- 原文:
- 作者:mudontire
fundebug经授权转载,版权归原作者所有。
webpack已经流行好久了,但很多同学使用webpack时还是一头雾水,一下看到那么多文档、各种配置、各种loader、plugin立马就晕头转向了。我也不例外,以至于很长一段时间对webpack都是一知半解的状态。但是想要继续做好前端,webpack是必须得跨过的一道坎,其实掌握webpack并不难,只是我们没有找到正确的方法。本文就是我自己在学习webpack时的一点心得体会,供大家参考。
什么是webpack?
一句话概括:webpack是一个模块打包工具(module bundler)。重点在于两个关键词“模块”和“打包”。什么是模块呢?我们回顾一下曾经的前端开发方式,js文件通过script
标签静态引入,js文件之间由于没有强依赖关系,如果文件1要用到文件2的某些方法或变量,则必须将文件1放到文件2后面加载。随着项目的增大,js文件之间的依赖关系越发错综复杂,维护难度也越来越高。这样的困境驱使着前端工程师们不断探索新的开发模式,从后端、app的开发模式中我们获得灵感,为什么不能引入“模块”的概念让js文件之间可以相互引用呢?模块1要使用模块2的功能,只需要在该模块1中明确引用模块2就行了,而不用担心它们的排列顺序。基于这种理念,commonjs和 amd规范被创造了出来,然后有了require.js、system.js这样的前端模块加载工具和node的模块系统,直到现在流行的es6 module。
模块的引入解决了文件之间依赖引用的问题,而打包则解决了文件过多的问题。当项目规模增大,模块的数量数以千计,浏览器如果要加载如此多的文件,页面加载的速度势必会受影响,而bundler可以把多个关联的文件打包到一起从而大量减少文件的数量提高网页加载性能。提供模块化的开发方式和编译打包功能就是webpack的核心,其他很多功能都围绕它们展开。
核心概念
module(模块)
对于webpack,模块不仅仅是javascript模块,它包括了任何类型的源文件,不管是图片、字体、json文件都是一个个模块。webpack支持以下的方式引用模块:
-
es2015
import
方法 -
commonjs
require()
方法 -
amd
define
和require
语法 - css/sass/less文件中的 @import 语法
-
url(...)
和<img src=...>
中的图片路径
dependency graph(依赖关系图)
所谓的依赖关系图是webpack根据每个模块之间的依赖关系递归生成的一张内部逻辑图,有了这张依赖关系图,webpack就能按图索骥把所有需要模块打包成一个bundle文件了。
entry(入口)
绘制依赖关系图的起始文件被称为entry。默认的entry为 ./src/index.js
,或者我们可以在配置文件中配置。entry可以为一个也可以为多个。
单个entry:
module.exports = { entry: './src/index.js' }
或者
module.exports = { entry: { main: './src/index.js' } };
多个entry,一个chunk
我们也可以指定多个独立的文件为entry,但将它们打包到一个chunk中,此种方法被称为 multi-main entry,我们需要传入文件路径的数组:
module.exports = { entry: ['./src/index.js', './src/index2.js', './src/index3.js'] }
但是改种方法的灵活性和扩展性有限,因此并不推荐使用。
多个entry,多个chunk
如果有多个entry,并且每个entry生成对应的chunk,我们需要传入object:
module.exports = { entry: { app: './src/app.js', admin: './src/admin.js' } };
这种写法有最好的灵活性和扩展性,支持和其他的局部配置(partial configuration)进行合并。比如将开发环境和生产的配置分离,并抽离出公共的配置,在不同的环境下运行时再将环境配置和公共配置进行合并。
output(出口)
有了入口,对应的就有出口。顾名思义,出口就是webpack打包完成的输出,output定义了输出的路径和文件名称。webpack的默认的输出路径为 ./dist/main.js
。同样,我们可以在配置文件中配置output:
module.exports = { entry: './src/index.js', output: { path: __dirname + '/dist', filename: 'bundle.js' } };
多个entry的情况
当有多个entry的时候,一个entry应该对应一个output,此时输出的文件名需要使用声明以确保文件名的唯一性,例如使用入口模块的名称:
module.exports = { entry: { app: './src/app.js', search: './src/search.js' }, output: { filename: '[name].js', path: __dirname + '/dist' } }
最终在 ./dist
路径下面会生成 app.js
和search.js
两个bundle文件。
loader
webpack自身只支持加载js和json模块,而webpack的理念是让所有的文件都能被引用和加载并生成依赖关系图,所以loader出场了。loader能让webpack能够去处理其他类型的文件(比如图片、字体文件、xml)。我们可以在配置文件中这样定义一个loader:
webpack.config.js
module.exports = { module: { rules: [ { test: /\.txt$/, use: 'raw-loader' } ] } };
其中test
定义了需要被转化的文件或者文件类型,use
定义了对该文件进行转化的loader的类型。该条配置相当于告诉webpack当遇到一个txt文件的引用时(使用require或者import进行引用),先用raw-loader
转换一下该文件再把它打包进bundle。
还有其他各种类型的loader,比如加载css文件的css-loader
,加载图片和字体文件的file-loader
,加载html文件的html-loader
,将最新js语法转换成es5的babel-loader
等等。完整列表请参考 。
plugin(插件)
plugin和loader是两个比较混淆和模糊的概念。loader是用来转换和加载特定类型的文件,所以loader的执行层面是单个的源文件。而plugin可以实现的功能更强大,plugin可以监听webpack处理过程中的关键事件,深度集成进webpack的编译器,可以说plugin的执行层面是整个构建过程。plugin系统是构成webpack的主干,webpack自身也基于plugin系统搭建,webpack有丰富的内置插件和外部插件,并且允许用户自定义插件。官方列出的插件有 。
与loader不同,使用plugin我们必须先引用该插件,例如:
const webpack = require('webpack'); // 用于引用webpack内置插件 const htmlwebpackplugin = require('html-webpack-plugin'); // 外部插件 module.exports = { plugins: [ new webpack.hotmodulereplacementplugin(), new htmlwebpackplugin({template: './src/index.html'}) ] };
推荐大家使用fundebug,一款很好用的bug监控工具~
实践
了解webpack的基本概念之后,我们通过实践来加深理解。接下来,我们使用webpack搭建一个简易的react脚手架。
创建项目
首先创建react-webpack-starter
项目并使用 npm init
初始化。
安装依赖
安装react
npm i react react-dom
安装webpack相关
npm i -d webpack webpack-cli webpack-dev-server html-webpack-plugin style-loader css-loader
安装webpack-cli
后可以在命令行中执行webpack命令;webpack-dev-server
提供了简易的web服务器,并且在修改文件之后自动执行webpack的编译操作并自动刷新浏览器,省去了重复的手动操作;html-webpack-plugin
用于自动生成index.html
文件,并且在index.html
中自动添加对bundle文件的引用;style-loader
和css-loader
用于加载css文件。
安装babel相关
由于react中使用了class
, import
这样的es6的语法,为了提高网站的浏览器兼容性,我们需要用babel转换一下。
npm i -d @babel/core @babel/preset-env @babel/preset-react babel-loader
其中@babel/core
是babel的核心模块,包含了babel的核心功能;@babel/preset-env
支持转换es6以及更新的js语法,并且可根据需要兼容的浏览器类型选择加载的plugin从而精简生成的代码;@babel/preset-react
包含了babel转换react所需要的plugin;babel-loader
是webpack的babel加载器。
配置webpack
在项目根目录下面新建webpack.config.js
,内容如下:
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' }, module: { rules: [ { test: /\.js$/, exclude: /node_module/, use: 'babel-loader' }, { test: /\.css$/, use: ['style-loader', 'css-loader'] // 注意排列顺序,执行顺序与排列顺序相反 } ] }, plugins: [ new htmlwebpackplugin({ template: './src/index.html' }) ] }
其中htmlwebpackplugin
使用自定义的模版来生成html 文件,模版的内容如下:
./src/index.html
<!doctype html> <html lang="en"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <meta http-equiv="x-ua-compatible" content="ie=edge"> <title>my react app</title> </head> <body> <div id="app"></div> </body> </html>
配置babel
在项目根目录下面新建.babelrc
文件,配置我们安装的两个babel preset:
.babelrc
{ "presets": [ "@babel/preset-env", "@babel/preset-react" ] }
生成react应用根节点
./src/index
import react from 'react'; import reactdom from 'react-dom'; import app from './components/app'; reactdom.render(<app />, document.getelementbyid('app'));
./src/component/app.js
import react, { component } from 'react'; import './app.css'; export default class app extends component { render() { return ( <div> my react webpack starter </div> ) } }
./src/components/app.css
body{ font-size: 60px; font-weight: bolder; color: red; text-transform: uppercase; }
配置 package.json
最后,在package.json
文件里面加上两个scripts,用来运行开发服务器和打包:
package.json
"scripts": { "start": "webpack-dev-server --mode development --open --hot", "build": "webpack --mode production" }
注意,我们启用了webpack-dev-server
的模块热更新功能(hmr),进一步提高我们的开发效率。
到此一个最简版本的react脚手架就搭建完成了,我们运行一下看看效果:
是不是没有想象中的那么难呢?当然webpack还有很多其他的功能和特性需要掌握,希望在参考本文之后大家进一步的学习更加顺利