在正式介绍Webpack之前,先给大家说明一下前端为什么需要模块化
在网页开发的早期,js制作作为一种脚本语言,做一些简单的表单验证或动画实现等,那个时候代码还是很少的。那个时候的代码是怎么写的呢?直接将代码写在标签中即可。随着ajax异步请求的出现,慢慢形成了前后端的分离,客户端需要完成的事情越来越多,代码量也是与日俱增。为了应对代码量的剧增,我们通常会将代码组织在多个js文件中,进行维护。但是这种维护方式,依然不能避免一些灾难性的问题。比如全局变量同名问题,看下面的例子:
小明后来发现代码不能正常运行,去检查自己的变量,发现确实true,最后杯具发生了,小明加班到2点还是没有找到问题出在哪里(所以,某些加班真的是无意义的)
另外,这种代码的编写方式对js文件的依赖顺序几乎是强制性的,但是当js文件过多,比如有几十个的时候,弄清楚它们的顺序是一件比较同时的事情。而且即使你弄清楚顺序了,也不能避免上面出现的这种尴尬问题的发生。
我们可以使用匿名函数来解决方面的重名问题在aaa.js文件中,我们使用匿名函数
(function(){
var flag=true
})()
但是如果我们希望在main.js文件中,用到flag,应该如何处理呢?显然,另外一个文件中不容易使用,因为flag是一个局部变量。
我们可以使用将需要暴露到外面的变量,使用一个模块作为出口,什么意思呢?来看下对应的代码:
我们做了什么事情呢?非常简单,在匿名函数内部,定义一个对象。给对象添加各种需要暴露到外面的属性和方法(不需要暴露的直接定义即可)。最后将这个对象返回,并且在外面使用了一个MoudleA接受。接下来,我们在man.js中怎么使用呢?我们只需要使用属于自己模块的属性和方法即可。这就是模块最基础的封装,事实上模块的封装还有很多高级的话题,但是我们这里就是要认识一下为什么需要模块,以及模块的原始雏形。幸运的是,前端模块化开发已经有了很多既有的规范,以及对应的实现方案。常见的模块化规范CommonJS、AMD、CMD,也有ES6的Modules
模块化有两个核心:导出和导入
CommonJS的导出:
CommonJS的导入:
export基本使用:
export指令用于导出变量,比如下面的代码:
export let name = 'wugongzi'
export let age = 19
上面的代码还有另外一种写法:
let name = 'wugongzi'
let age = 19
export {
name,age}
导出函数或类:
上面的代码主要输出变量,也可以输出函数或者输出类
export function test(content) {
console.log(content)
}
export class Person{
constructor(name,age){
this.name=name;
this.age=age;
}
run() {
console.log(this.name + '在奔跑')
}
}
或者是下面这种形式:
function test(content) {
console.log(content)
}
class Person{
constructor(name,age){
this.name=name;
this.age=age;
}
run() {
console.log(this.name + '在奔跑')
}
}
export {
test,Person}
export default:
某些情况下,一个模块中包含某个的功能,我们并不希望给这个功能命名,而且让导入者可以自己来命名,这个时候就可以使用export default
//info.js
export default function() {
console.log('default function')
}
我们来到main.js中,这样使用就可以了,这里的myFunc是我自己命名的,你可以根据需要命名它对应的名字
import myFunc from './info.js'
myFunc()
注意:export default 在同一模块中不允许同时存在多个
import:
我们使用export指令导出了模块对外提供的接口,下面我们就可以通过import命令来加载对应的这个模块了
首先,我们需要在HTML代码中引入两个js文件,并且类型需要设置为module
<script src="info.js" type="module"></script>
<script src="main.js" type="module"></script>
import指令用于导入模块中的内容,比如main.js的代码
import {
name,age} from './info.js'
console.log(name,age)
如果我们希望某个模块中所有的信息都导入,一个个导入显然有些麻烦:通过*
可以导入模块中所有的export变量
但是通常情况下我们需要给*
起一个别名,方便后续的使用
import * as info from './info.js'
console.log(info.name,info.age)
什么是webpack?这个webpack还真不是一两句话可以说清楚的。我们先看看官方的解释:
At its core, webpack is a static module bundler for modern JavaScript applications.
从本质上来讲,webpack是一个现代的JavaScript应用的静态模块打包工具。但是它是什么呢?用概念解释概念,还是不清晰。我们从两个点来解释上面这句话:模块 和 打包
在前面学习中,我已经用了大量的篇幅解释了为什么前端需要模块化。而且我也提到了目前使用前端模块化的一些方案:AMD、CMD、CommonJS、ES6。在ES6之前,我们要想进行模块化开发,就必须借助于其他的工具,让我们可以进行模块化开发。并且在通过模块化开发完成了项目后,还需要处理模块间的各种依赖,并且将其进行整合打包。而webpack其中一个核心就是让我们可能进行模块化开发,并且会帮助我们处理模块间的依赖关系。而且不仅仅是JavaScript文件,我们的CSS、图片、json文件等等在webpack中都可以被当做模块来使用(在后续我们会看到)。这就是webpack中模块化的概念。
打包如何理解呢?理解了webpack可以帮助我们进行模块化,并且处理模块间的各种复杂关系后,打包的概念就非常好理解了。就是将webpack中的各种资源模块进行打包合并成一个或多个包(Bundle)。并且在打包的过程中,还可以对资源进行处理,比如压缩图片,将scss转成css,将ES6语法转成ES5语法,将TypeScript转成JavaScript等等操作。但是打包的操作似乎grunt/gulp也可以帮助我们完成,它们有什么不同呢?
grunt/gulp的核心是Task,我们可以配置一系列的task,并且定义task要处理的事务(例如ES6、ts转化,图片压缩,scss转成css),之后让grunt/gulp来依次执行这些task,而且让整个流程自动化。所以grunt/gulp也被称为前端自动化任务管理工具。我们来看一个gulp的task:
上面的task就是将src下面的所有js文件转成ES5的语法。并且最终输出到dist文件夹中。什么时候用grunt/gulp呢?如果你的工程模块依赖非常简单,甚至是没有用到模块化的概念。只需要进行简单的合并、压缩,就使用grunt/gulp即可。但是如果整个项目使用了模块化管理,而且相互依赖非常强,我们就可以使用更加强大的webpack了。所以,grunt/gulp和webpack有什么不同呢?
grunt/gulp更加强调的是前端流程的自动化,模块化不是它的核心。
webpack更加强调模块化开发管理,而文件压缩合并、预处理等功能,是他附带的功能。
在使用webpack之前我们需要先安装webpack,安装webpack首先需要安装Node.js,Node.js自带了软件包管理工具npm。Node.js安装比较简单,从官网下载安装包后一路next即可安装成功,安装好了以后记得配置环境变量(环境变量的具体配置不会的可以参考下网上的教程)。
安装好了以后可以通过node -v
查看自己的Node版本
全局安装webpack:
npm install webpack -g
局部安装webpack:(后续项目中会用到)
cd 项目对应目录
//@3.6.0是版本号 --save-dev是开发时依赖,项目打包后不需要继续使用的。
npm install webpack@3.6.0 --save-dev
为什么全局安装后,还需要局部安装呢?在终端直接执行webpack命令,使用的全局安装的webpack。当在package.json中定义了scripts时,其中包含了webpack命令,那么使用的是局部webpack
我们创建如下文件和文件夹:
dist文件夹:用于存放之后打包的文件(目前为空)
src文件夹:用于存放我们写的源文件
index.html:浏览器打开展示的首页html
package.json:通过npm init生成的,npm包管理的文件(暂时没有用上,后面才会用上)
mathUtils.js中的代码:
function add(num1,num2){
return num1+num2;
}
function mul(num1,num2){
return num1*num2;
}
module.exports = {
add,mul
}
main.js中的代码:
const math = require('./mathUtils.js')
console.log('Hello webpakc');
console.log(math.add(10,20));
console.log(math.mul(10,20));
现在的js文件中使用了模块化的方式进行开发,他们可以直接使用吗?不可以。因为如果直接在index.html引入这两个js文件,浏览器并不识别其中的模块化代码。另外,在真实项目中当有许多这样的js文件时,我们一个个引用非常麻烦,并且后期非常不方便对它们进行管理。
我们应该怎么做呢?使用webpack工具,对多个js文件进行打包。我们知道,webpack就是一个模块化的打包工具,所以它支持我们代码中写模块化,可以对模块化的代码进行处理。(如何处理的,待会儿在原理中,我会讲解)另外,如果在处理完所有模块之间的关系后,将多个js打包到一个js文件中,引入时就变得非常方便了。那么该如何打包呢?
我们可以在终端使用
webpack .\src\main.js -o .\dist\bundle.js
进行打包,如果自己的webpack版本较低,可以使用webpack .\src\main.js .\dist\bundle.js这个命令
打包后会在dist文件下,生成一个bundle.js文件。文件内容有些复杂,这里暂时先不看,后续再进行分析。bundle.js文件,是webpack处理了项目直接文件依赖后生成的一个js文件,我们只需要将这个js文件在index.html中引入即可,不需要再像之前那样需要引入很多JS文件
<html>
<head>
<meta charset="utf-8">
<title>title>
head>
<body>
<script src="dist/bundle.js" type="text/javascript" charset="utf-8">script>
body>
html>
在浏览器中运行index.html便可在控制台看到输出效果
上面我们已经了解了webpack是什么以及怎么用,下面我们来学习该如何进行webpack的配置
我们考虑一下,如果每次使用webpack的命令都需要写上入口和出口作为参数,就非常麻烦,有没有一种方法可以将这两个参数写到配置中,在运行时,直接读取呢?当然可以,就是创建一个webpack.config.js文件,内容如下
const path = require('path');
module.exports = {
//入口:可以是字符串、数组、对象
entry: './src/main.js',
//出口:通常是一个对象,里面至少包含两个属性,path和filename
output: {
path: path.resolve(__dirname, 'dist'), //注意 path通常是一个决定路径
filename: 'bundle.js'
}
};
这时我们在终端中只需要输入webpakc即可打包
目前,我们使用的webpack是全局的webpack,如果我们想使用局部来打包呢?因为一个项目往往依赖特定的webpack版本,全局的版本可能很这个项目的webpack版本不一致,导出打包出现问题。所以通常一个项目,都有自己局部的webpack。第一步,项目中需要安装自己局部的webpack。这里我们让局部安装webpack3.6.0,Vue CLI3中已经升级到webpack4,但是它将配置文件隐藏了起来,所以查看起来不是很方便。
安装命令:(注意,一定先进入你的项目路径下,然后输入命令)
npm install webpack@3.6.0 --save-dev
刚才在上一步我们已经安装好局部webpack,那么我们该如何使用局部webpack进行打包呢?如果你此时在命令行中输入webpack命令,那么依然是使用全局的webpack,因此我们还需要对此进行配置
首先我们通过npm init
生成package.json,
{
"name": "day04",
"version": "1.0.0",
"description": "package.json test",
"main": "webpack.config.js",
"dependencies": {
"webpack": "^3.6.0"
},
"devDependencies": {
},
"scripts": {
"build": "webpack" //加上这一句,当我们执行npm run build时它会去我们局部的webpack中去寻找命令,如果找不到再去全局寻找
},
"author": "wugongzi",
"license": "ISC"
}
生成好package.json后我们可以使用npm run build
来打包我们的项目。当我们执行npm run build时它首先会去我们局部的webpack中去寻找命令,如果找不到再去全局寻找
loader是webpack中一个非常核心的概念。webpack用来做什么呢?在我们之前的实例中,我们主要是用webpack来处理我们写的js代码,并且webpack会自动处理js之间相关的依赖。但是,在开发中我们不仅仅有基本的js代码处理,我们也需要加载css、图片,也包括一些高级的将ES6转成ES5代码,将TypeScript转成ES5代码,将scss、less转成css,将.jsx、.vue文件转成js文件等等。对于webpack本身的能力来说,对于这些转化是不支持的。那怎么办呢?给webpack扩展对应的loader就可以啦。
loader使用过程:
步骤一:通过npm安装需要使用的loader
步骤二:在webpack.config.js中的modules关键字下进行配置
大部分loader我们都可以在webpack的官网中找到,并且学习对应的用法。
项目开发过程中,我们必然需要添加很多的样式,而样式我们往往写到一个单独的文件中。在src目录中,创建一个css文件,其中创建一个normal.css文件。我们也可以重新组织文件的目录结构,将零散的js文件放在一个js文件夹中。normal.css中的代码非常简单,就是将body设置为red但是,这个时候normal.css中的样式会生效吗?当然不会,因为我们压根就没有引用它。webpack也不可能找到它,因为我们只有一个入口,webpack会从入口开始查找其他依赖的文件。
normal.css
body {
background-color: red;
}
在main.js中引入
//引入CSS文件
require('./css/normal.css')
重新打包,出现如下错误
这个错误告诉我们:加载normal.css文件必须有对应的loader。
这时,我们打开webpack的官网https://www.webpackjs.com/loaders/css-loader/,找到对应的css-loader的配置。loader的配置按照官网的要求来就可以,安装好对应的loader后,我们需要在webpack.config.js中加入相应的配置
const path = require('path');
module.exports = {
//入口:可以是字符串、数组、对象
entry: './src/main.js',
//出口:通常是一个对象,里面至少包含两个属性,path和filename
output: {
path: path.resolve(__dirname, 'dist'), //注意 path通常是一个决定路径
filename: 'bundle.js'
},
module: {
//引入 css配置
rules: [{
test: /\.css$/,
use: ['style-loader', 'css-loader']
}]
}
};
**注意:**使用css-loader前必须引入style-loader,不然在页面看不到效果
如果我们希望在项目中使用less、scss、stylus来写样式,webpack是否可以帮助我们处理呢?我们这里以less为例,其他也是一样的。我们还是先创建一个less文件,依然放在css文件夹中
继续在官方中查找,我们会找到less-loader相关的使用说明。首先,还是需要安装对应的loader。注意:我们这里还安装了less,因为webpack会使用less对less文件进行编译。其次,修改对应的配置文件,添加一个rules选项,用于处理.less文件
npm install --save-dev less-loader less
首先,我们在项目中加入两张图片:一张较小的图片test01.jpg(小于8kb),一张较大的图片test02.jpeg(大于8kb),待会儿我们会针对这两张图片进行不同的处理
我们先考虑在css样式中引用图片的情况,所以我更改了normal.css中的样式:
如果我们现在直接打包,会出现如下问题
图片处理,我们使用url-loader来处理,依然先安装url-loader
npm install --save-dev url-loader
修改webpack-config.js
再次打包,运行index.html,就会发现我们的背景图片选出了出来。而仔细观察,你会发现背景图是通过base64显示出来的。OK,这也是limit属性的作用,当图片小于8kb时,对图片进行base64编码
那么问题来了,如果图片大于8kb呢?我们将background的图片改成test02.jpg,这次因为大于8kb的图片,会通过file-loader进行处理,但是我们的项目中并没有file-loader
所以我们需要安装file-loader
npm install --save-dev file-loader
再次打包,就会发现dist文件夹下多了一个图片文件
我们发现webpack自动帮助我们生成一个非常长的名字,这是一个32位hash值,目的是防止名字重复。但是,真实开发中,我们可能对打包的图片名字有一定的要求,比如,将所有的图片放在一个文件夹中,跟上图片原来的名称,同时也要防止重复。所以,我们可以在options中添加上如下选项:
img:文件要打包到的文件夹
name:获取图片原来的名字,放在该位置
hash:8:为了防止图片名称冲突,依然使用hash,但是我们只保留8位
ext:使用图片原来的扩展名
但是,我们发现图片并没有显示出来,这是因为图片使用的路径不正确,默认情况下,webpack会将生成的路径直接返回给使用者。但是,我们整个程序是打包在dist文件夹下的,所以这里我们需要在路径下再添加一个dist/
如果你仔细阅读webpack打包的js文件,发现写的ES6语法并没有转成ES5,那么就意味着可能一些对ES6还不支持的浏览器没有办法很好的运行我们的代码。在前面我们说过,如果希望将ES6的语法转成ES5,那么就需要使用babel。而在webpack中,我们直接使用babel对应的loader就可以了。
npm install --save-dev babel-loader@7 babel-core babel-preset-es2015
配置webpack.config.js文件
重新打包,查看bundle.js文件,发现其中的内容变成了ES5的语法