内容概述

目录

认识webpack

webpack的安装#webpack%E7%9A%84%E5%AE%89%E8%A3%85

webpack的起步

webpack的配置

loader的使用

webpack中配置Vue

plugin的使用

搭建本地服务器


认识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)

 但是打包的操作似乎grunt/gulp也可以帮助我们完成,它们有什么不同呢?


webpack的安装

首先我们需要知道,webpack的运行需要node环境的支持,而npm是node环境中的一个软件包管理工具(node packages manager)

查看自己的node版本:

全局安装webpack(这里我先指定版本号3.6.0,因为vue cli2依赖该版本)


webpack的起步

我们创建如下文件和文件夹:

dist文件夹:用于存放之后打包的文件 src文件夹:用于存放我们写的源文件

main.js:项目的入口文件。具体内容查看下面详情。

mathUtils.js:定义了一些数学工具函数,可以在其他地方引用,并且使用。具体内容查看下面的详情。

index.html:浏览器打开展示的首页html

main.js:

const {add,mul}=require('./mathUtils')
console.log(add(20, 30));
console.log(mul(10, 80));
import * as aaa from './info'

console.log(aaa.name);
console.log(aaa.height);
console.log(aaa.age);

mathUtils.js

function add(num1,num2){
    return num1+num2
}
function mul(num1,num2){
    return num1*num2
}
module.exports={
    add,
    mul
}

index.html

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Title</title>
</head>
<body>
<script src="./dist/bundle.js"></script>
</body>
</html>

可以看到,我们在index.html文件中并没有引用我们的mathUtils.js,且我们的main.js文件中导入了mathUtils.js文件,可是我们却引用了一个bundle.js的文件,那么这个bundle.js文件是哪里来的呢?

这个bundle.js文件正是我们使用webpack打包main.js得来的

在我们的terminal终端中输入这么一条语句 webpack ./src/main.js ./dist/bundle.js

这条语句的意思是将我们的 ./src/main.js文件打包成bundle.js文件并存放在dist文件夹中

注意!首次安装webpack的同学们可能会遇到脚本禁止运行的错误,此时重启我们的电脑,以管理员身份打开我们的编译软件,并在终端先输入Set-ExecutionPolicy RemoteSigned使我们的脚本可以正常运行,随后再输入我们的webpack ./src/main.js ./dist/bundle.js

此时打开我们的index.html,发现我们的index页面可以打印出我们所需要的语句


webpack的配置

入口和出口

我们考虑一下,如果每次使用webpack的命令都需要写上入口和出口作为参数,就非常麻烦,有没有一种方法可以将这两个参数写到配置中,在运行时,直接读取呢?

当然可以,就是创建一个webpack.config.js文件

注意:我们这里的path必须是一个绝对路径,而我们绝对路径的获取通常是由第一行代码require('path')获取的

局部安装webpack

目前,我们使用的webpack是全局的webpack,如果我们想使用局部来打包呢?

因为一个项目往往依赖特定的webpack版本,全局的版本可能很这个项目的webpack版本不一致,导出打包出现问题。

所以通常一个项目,都有自己局部的webpack

第一步,项目中需要安装自己局部的webpack 这里我们让局部安装webpack3.6.0

执行了这一步以后,我们便拥有了开发时依赖的局部webpack,并且他的版本是3.6.0

第二步,通过node_modules/.bin/webpack启动webpack打包 (这一步比较麻烦,不po代码了,我们用另一种方法)

第二部的替代:

我们可以在package.jsonscripts中定义自己的执行脚本

package.json中的scripts的脚本在执行时,会按照一定的顺序寻找命令对应的位置。

首先,会寻找本地的node_modules/.bin路径中对应的命令。

 

如果没有找到,会去全局的环境变量中寻找。 如何执行我们的build指令呢?

 


loader的使用

什么是loader?

loader是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关键字下进行配置

比如说,我们现在写好了一个CSS文件,我们如何将我们写好的CSS文件打包进我们的bundle.js文件呢?

①、在src目录中,创建一个css文件,其中创建一个normal.css文件。 我们也可以重新组织文件的目录结构,将零散的js文件放在一个js文件夹中。

这个时候我们的normal.css中的样式会生效吗? 

当然不会,因为我们压根就没有引用它。

webpack也不可能找到它,因为我们只有一个入口,webpack会从入口开始查找其他依赖的文件。

 

 重新打包,但是你会发现我们没办法将CSS打包进我们的bundle.js文件,会出现如下错误:

这是因为我们并没有配置相关的loader 

在webpack的官方中,我们可以找到如下关于样式的loader使用方法:

按照官方配置webpack.config.js文件webpack官网入口

注意:配置中有一个style-loader,我们并不知道它是什么,所以可以暂时不进行配置。

重新打包项目:npm run build 运行index.html,你会发现样式并没有生效。

 原因是css-loader只负责加载css文件,但是并不负责将css具体样式嵌入到文档中。 这个时候,我们还需要一个style-loader帮助我们处理。

所以我们再去一次webpack的官网我们来安装style-loader(和上面的css-loader一样的步骤)

 疑惑:不对吧?按照我们的逻辑,在处理css文件过程中,应该是css-loader先加载css文件再由style-loader来进行进一步的处理,为什么会将style-loader放在前面呢?

答案:这次因为webpack在读取使用的loader的过程中,是按照从右向左的顺序读取的。(本质上依旧是先加载CSS文件,再由style-loader处理,但是webpack读取顺序不同所以反着写)

webpack.config.js的配置如下:

注意!!!笔者亲身遇到的问题!一定需要注意你所安装的css-loader及style-loader版本是否与webpack版本对应,如果不对应的话是会报错的

在这篇文章中我们用的webpack版本是@3.6.0,css-loader版本是@2.0.2,style-loader版本是@0.23.1

less文件处理 – 准备工作

如果我们希望在项目中使用less、scss、stylus来写样式,webpack是否可以帮助我们处理呢? 我们这里以less为例,其他也是一样的。 我们还是先创建一个less文件,依然放在css文件夹中

继续在官方中查找,我们会找到less-loader相关的使用说明 首先,还是需要安装对应的loader 注意:我们这里还安装了less,因为webpack会使用less对less文件进行编译

npm install --save-dev less-loader@4.1.0 less@3.9.0

其次,修改对应的配置文件 添加一个rules选项,用于处理.less文件

 图片文件处理 – 资源准备阶段

首先,我们在项目中加入两张图片: 一张较小的图片test.jpg(小于8kb),一张较大的图片secondtest.jpeg(大于8kb) 待会儿我们会针对这两张图片进行不同的处理 我们先考虑在css样式中引用图片的情况,所以我更改了normal.css中的样式:

如果我们现在直接打包,会出现如下问题

 图片处理,我们使用url-loader来处理,依然先安装url-loader

npm install --save-dev url-loader@1.1.2

 修改webpack.config.js配置文件:

再次打包,运行index.html,就会发现我们的背景图片选出了出来。 而仔细观察,你会发现背景图是通过base64显示出来的 OK,这也是limit属性的作用,当图片小于8kb时,对图片进行base64编码

那么问题来了,如果大于8kb呢?我们将background的图片改成secondtest.jpg 这次因为大于8kb的图片,会通过file-loader进行处理,但是我们的项目中并没有file-loader 

所以,我们需要安装file-loader 

npm install --save-dev file-loader@3.0.1

再次打包,就会发现dist文件夹下多了一个图片文件

我们发现webpack自动帮助我们生成一个非常长的名字 这是一个32位hash值,目的是防止名字重复 但是,真实开发中,我们可能对打包的图片名字有一定的要求 比如,将所有的图片放在一个文件夹中,跟上图片原来的名称,同时也要防止重复 

所以,我们可以在options中添加上如下选项:

img:文件要打包到的文件夹

name:获取图片原来的名字,放在该位置

hash:8:为了防止图片名称冲突,依然使用hash,但是我们只保留8位

ext:使用图片原来的扩展名

这个时候我们再打包一次发现我们打包的图片姓名已经是我们需要的了

但是,我们发现图片并没有显示出来,

这是因为图片使用的路径不正确

默认情况下,webpack会将生成的路径直接返回给使用者

但是,我们整个程序是打包在dist文件夹下的,所以这里我们需要在路径下再添加一个dist/

选看(现在用的比较少):ES6语法处理

如果你仔细阅读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的语法 


webpack中配置Vue

引入vue.js

后续项目中,我们会使用Vuejs进行开发,而且会以特殊的文件来组织vue的组件。 所以,下面我们来学习一下如何在我们的webpack环境中集成Vuejs 现在,我们希望在项目中使用Vuejs,那么必然需要对其有依赖,所以需要先进行安装 注:因为我们后续是在实际项目中也会使用vue的,所以并不是开发时依赖

那么,接下来就可以按照我们之前学习的方式来使用Vue了 

 

 el和template区别(一)

 们来考虑另外一个问题: 如果我们希望将data中的数据显示在界面中,就必须是修改index.html 如果我们后面自定义了组件,也必须修改index.html来使用组件 但是html模板在之后的开发中,我并不希望手动的来频繁修改,是否可以做到呢?

 定义template属性: 在前面的Vue实例中,我们定义了el属性,用于和index.html中的#app进行绑定,让Vue实例之后可以管理它其中的内容 这里,我们可以将div元素中的{{message}}内容删掉,只保留一个基本的id为app的元素 但是如果我依然希望在其中显示{{message}}的内容,应该怎么处理呢? 我们可以再定义一个template属性,代码如下:

重新打包,运行程序,显示一样的结果和HTML代码结构

那么,el和template模板的关系是什么呢?

在我们之前的学习中,我们知道el用于指定Vue要管理的DOM,可以帮助解析其中的指令、事件监听等等。

而如果Vue实例中同时指定了template,那么template模板的内容会替换掉挂载的对应el的模板

这样做有什么好处呢?

这样做之后我们就不需要在以后的开发中再次操作index.html,只需要在template中写入对应的标签即可

但是,书写template模块非常麻烦怎么办呢? 没有关系,稍后我们会将template模板中的内容进行抽离。 会分成三部分书写:template、script、style,结构变得非常清晰。

Vue组件化开发引入

我们也可以将上面所提到的问题代码抽取到一个js文件中,并且导出。

但是一个组件以一个js对象的形式进行组织和使用的时候是非常不方便的

一方面编写template模块非常的麻烦 

另外一方面如果有样式的话,我们写在哪里比较合适呢

所以,我们以一种全新的方式来组织一个vue的组件

我们在src文件夹中新建一个Vue文件夹,并在Vue文件夹中新建一个.vue文件,并将我们的模板template,数据data,方法methods传入.vue文件中

并在main.js文件中导入我们的.vue文件

 这个时候我们再用我们的webpack对.vue文件进行打包,但是,这个时候这个文件可以被正确的加载吗? 必然不可以,这种特殊的文件以及特殊的格式,必须有人帮助我们处理。 谁来处理呢?vue-loader以及vue-template-compiler。

 安装vue-loader和vue-template-compiler(和之前安装各种loader的套路一样,npm install即可,要注意版本对应。安装完后记得更改webpack.config.js文件中的配置)

但是!我们这里遇到了一个问题,loader安装完以后依然报错

报错信息显示我们缺少了插件,插件的话我们下一节会提到,这里我们的解决方法就是安装一个较低版本的vue-loader即可,建议安装@13.x.x版本

然后我们再进行打包,这个时候我们就大功告成啦。以后写Vue的代码可以直接在.vue文件中写入,在main.js文件导入,再利用webpack工具打包即可

所以以后我们在写代码的时候,Vue是一个组件化开发的思想,我们以后开发只需要新建一个个.vue文件即可,然后封装成一个组件,在父组件进行导入使用即可

举栗子:

我们新建了一个Cpn.vue文件

随后我们在App.vue文件进行导入Cpn.vue文件,并在App.vue文件中注册我们的Cpn组件即可正常使用<Cpn/>组件标签了


plugin的使用

认识plugin

plugin是什么? plugin是插件的意思,通常是用于对某个现有的架构进行扩展。 webpack中的插件,就是对webpack现有功能的各种扩展,比如打包优化,文件压缩等等。

loader和plugin区别

loader主要用于转换某些类型的模块,它是一个转换器。 plugin是插件,它是对webpack本身的扩展,是一个扩展器。

plugin的使用过程:

步骤一:通过npm安装需要使用的plugins(某些webpack已经内置的插件不需要安装) 步骤二:在webpack.config.js中的plugins中配置插件。

一、添加版权的Plugin

我们先来使用一个最简单的插件,为打包的文件添加版权声明 该插件名字叫BannerPlugin,属于webpack自带的插件。 按照下面的方式来修改webpack.config.js的文件:

 

 重新打包后会发现我们的main.js文件最上方多了行版权声明

二、打包html的plugin

目前,我们的index.html文件是存放在项目的根目录下的。

我们知道,在真实发布项目时,发布的是dist文件夹中的内容,但是dist文件夹中如果没有index.html文件,那么打包的js等文件也就没有意义了。

所以,我们需要将index.html文件打包到dist文件夹中,这个时候就可以使用HtmlWebpackPlugin插件

安装HtmlWebpackPlugin插件

npm install html-webpack-plugin@3.2.0 --save-dev

使用插件,修改webpack.config.js文件中plugins部分的内容如下: 

这里的template表示根据什么模板来生成index.html

另外,我们需要删除之前在output中添加的publicPath属性 否则插入的script标签中的src可能会有问题

 三、丑化压缩打包JS代码

在项目发布之前,我们必然需要对js等文件进行压缩处理

这里,我们就对打包的js文件进行压缩 我们使用一个第三方的插件uglifyjs-webpack-plugin,并且版本号指定1.1.1,和CLI2保持一致

npm install uglifyjs-webpack-plugin@1.1.1 --save-dev

 查看打包后的bunlde.js文件,是已经被压缩过了。


搭建本地服务器

同学们在编写代码的时候有没有感觉,每改一行代码都要重新打包,然后再手动打开我们的index.html文件去检查自己的代码是否正常运行特别麻烦?

webpack提供了一个可选的本地开发服务器,这个本地服务器基于node.js搭建,内部使用express框架,可以实现我们想要的让浏览器自动刷新显示我们修改后的结果

不过它是一个单独的模块,在webpack中使用之前需要先安装它

npm install --save-dev webpack-dev-server@2.9.1

devserver也是作为webpack中的一个选项,选项本身可以设置如下属性:

contentBase:为哪一个文件夹提供本地服务,默认是根文件夹,我们这里要填写./dist

port:端口号

inline:页面实时刷新

historyApiFallback:在SPA页面中,依赖HTML5的history模式

 这个时候我们在我们的终端输入 webpack-dev-server即可,我们终端会跳出一个本地网址,我们点击进去即可检查我们的页面,而且这个页面是伴随我们的代码动态刷新的

那我们接下来也可以在package.json文件中配置script,且在后面加上--open参数(我们可以不再点击网址而是直接打开页面)

 这个时候我们在终端输入npm run dev即可

当我们调试完代码后再npm run build对代码进行打包发布即可

更多推荐

Vue中的webpack详解