现今的不少网页其实能够看作是功能丰富的应用,它们拥有着复杂的 JavaScript 代码和一大堆依赖包。为了简化开发的复杂度,前端社区涌现出了不少好的实践方法css
这些改进确实大大的提升了咱们的开发效率,可是利用它们开发的文件每每须要进行额外的处理才能让浏览器识别,而手动处理又是很是繁琐的,这就为WebPack类的工具的出现提供了需求。html
WebPack能够看作是模块打包机:它作的事情是,分析你的项目结构,找到JavaScript模块以及其它的一些浏览器不能直接运行的拓展语言(Scss,TypeScript等),并将其转换和打包为合适的格式供浏览器使用。前端
其实Webpack和另外两个并无太多的可比性,Gulp/Grunt是一种可以优化前端的开发流程的工具,而WebPack是一种模块化的解决方案,不过Webpack的优势使得Webpack在不少场景下能够替代Gulp/Grunt类的工具。node
Grunt和Gulp的工做方式是:在一个配置文件中,指明对某些文件进行相似编译,组合,压缩等任务的具体步骤,工具以后能够自动替你完成这些任务。react
Webpack的工做方式是:把你的项目当作一个总体,经过一个给定的主文件(如:index.js),Webpack将从这个文件开始找到你的项目的全部依赖文件,使用loaders处理它们,最后打包为一个(或多个)浏览器可识别的JavaScript文件。webpack
若是实在要把两者进行比较,Webpack的处理速度更快更直接,能打包更多不一样类型的文件。git
Webpack可使用npm安装,新建一个空的练习文件夹(此处命名为webpack),在终端中转到该文件夹后执行下述指令就能够完成安装。github
//全局安装 npm install -g webpack //安装到你的项目目录 npm install --save-dev webpack
1.在上述练习文件夹中建立一个package.json文件,这是一个标准的npm说明文件,里面蕴含了丰富的信息,包括当前项目的依赖模块,自定义的脚本任务等等。在终端中使用npm init命令能够自动建立这个package.json文件web
npm init
输入这个命令后,终端会问你一系列诸如项目名称,项目描述,做者等信息,不过不用担忧,若是你不许备在npm中发布你的模块,这些问题的答案都不重要,回车默认便可。正则表达式
2.package.json文件已经就绪,咱们在本项目中安装Webpack做为依赖包
// 安装Webpack npm install --save-dev webpack
3.回到以前的空文件夹,并在里面建立两个文件夹,app文件夹和public文件夹,app文件夹用来存放原始数据和咱们将写的JavaScript模块,public文件夹用来存放以后供浏览器读取的文件(包括使用webpack打包生成的js文件以及一个index.html文件)。接下来咱们再建立三个文件:
咱们在index.html文件中写入最基础的html代码,它在这里目的在于引入打包后的js文件(这里咱们先把以后打包后的js文件命名为bundle.js)。
<!-- index.html --> <!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>Webpack Sample Project</title> </head> <body> <div id='root'> </div> <script src="bundle.js"></script> </body> </html>
咱们在Greeter.js中定义一个返回包含问候信息的html元素的函数,并依据CommonJS规范导出这个函数为一个模块:
// Greeter.js module.exports = function() { var greet = document.createElement('div'); greet.textContent = "Hi there and greetings!"; return greet; };
main.js文件中咱们写入下述代码,用以把Greeter模块返回的节点插入页面
//main.js const greeter = require('./Greeter.js'); document.querySelector("#root").appendChild(greeter());
webpack能够在终端中使用,基本的使用方法以下:
# {extry file}出填写入口文件的路径,本文中就是上述main.js的路径, # {destination for bundled file}处填写打包文件的存放路径 # 填写路径的时候不用添加{} webpack {entry file} {destination for bundled file}
本文中代码就是
webpack app/main.js -o public/bundle.js
指定入口文件后,webpack将自动识别项目所依赖的其它文件,不过须要注意的是若是你的webpack不是全局安装的,那么当你在终端中使用此命令时,须要额外指定其在node_modules中的地址,继续上面的例子,在终端中输入以下命令:
# webpack非全局安装的状况 node_modules/.bin/webpack app/main.js public/bundle.js
最后结果以下
$ webpack app/main.js -o public/bundle.js Hash: dd810eb2fcb8dc5e898f Version: webpack 4.41.5 Time: 292ms Built at: 2020-01-19 11:19:00 Asset Size Chunks Chunk Names bundle.js 1.09 KiB 0 [emitted] main Entrypoint main = bundle.js [0] ./app/main.js 109 bytes {0} [built] [1] ./app/Greeter.js 165 bytes {0} [built]
能够看出webpack同时编译了main.js 和Greeter,js,如今打开index.html,就能够在页面上显示结果了。
如今咱们已经成功的使用Webpack打包了一个文件了。不过在终端中进行复杂的操做,实际上是不太方便且容易出错的,接下来看看Webpack的另外一种更常见的使用方法。
Webpack拥有不少其它的比较高级的功能(好比loaders和plugins),这些功能其实均可以经过命令行模式实现,可是正如前面提到的,这样不太方便且容易出错的,更好的办法是定义一个配置文件,这个配置文件其实也是一个简单的JavaScript模块,咱们能够把全部的与打包相关的信息放在里面。
继续上面的例子来讲明如何写这个配置文件,在当前练习文件夹的根目录下新建一个名为webpack.config.js的文件,咱们在其中写入以下所示的简单配置代码,目前的配置主要涉及到的内容是入口文件路径和打包后文件的存放路径。
module.exports = { entry: __dirname + "/app/main.js",//已屡次说起的惟一入口文件 output: { path: __dirname + "/public",//打包后的文件存放的地方 filename: "bundle.js"//打包后输出文件的文件名 } }
注:“__dirname”是node.js中的一个全局变量,它指向当前执行脚本所在的目录。
有了这个配置以后,再打包文件,只需在终端里运行webpack(非全局安装需使用node_modules/.bin/webpack)命令就能够了,这条命令会自动引用webpack.config.js文件中的配置选项,示例以下:
$ webpack Hash: dd810eb2fcb8dc5e898f Version: webpack 4.41.5 Time: 100ms Built at: 2020-01-19 11:33:43 Asset Size Chunks Chunk Names bundle.js 1.09 KiB 0 [emitted] main Entrypoint main = bundle.js [0] ./app/main.js 109 bytes {0} [built] [1] ./app/Greeter.js 165 bytes {0} [built]
而后就打包成功啦、
Loaders是webpack提供的最激动人心的功能之一了。经过使用不一样的loader,webpack有能力调用外部的脚本或工具,实现对不一样格式的文件的处理,好比说分析转换scss为css,或者把下一代的JS文件(ES6,ES7)转换为现代浏览器兼容的JS文件,对React的开发而言,合适的Loaders能够把React的中用到的JSX文件转换为JS文件。
Loaders须要单独安装而且须要在webpack.config.js中的modules关键字下进行配置,Loaders的配置包括如下几方面:
不过在配置loader以前,咱们把Greeter.js里的问候消息放在一个单独的JSON文件里,并经过合适的配置使Greeter.js能够读取该JSON文件的值,各文件修改后的代码以下:
在app文件夹中建立带有问候信息的JSON文件(命名为config.json)
{ "greetText": "Hi there and greetings from JSON!" }
更新后的Greeter.js
var config = require('./config.json'); module.exports = function() { var greet = document.createElement('div'); greet.textContent = config.greetText; return greet; };
Babel实际上是一个编译JavaScript的平台,它能够编译代码帮你达到如下目的:
Babel实际上是几个模块化的包,其核心功能位于称为babel-core的npm包中,webpack能够把其不一样的包整合在一块儿使用,对于每个你须要的功能或拓展,你都须要安装单独的包(用得最多的是解析Es6的babel-env-preset包和解析JSX的babel-preset-react包)。
咱们先来一次性安装这些依赖包
// npm一次性安装多个依赖模块,模块之间用空格隔开 npm install --save-dev babel-core babel-loader babel-preset-env babel-preset-react
在webpack中配置Babel的方法以下:
module.exports = { entry: __dirname + "/app/main.js",//已屡次说起的惟一入口文件 output: { path: __dirname + "/public",//打包后的文件存放的地方 filename: "bundle.js"//打包后输出文件的文件名 }, devtool: 'eval-source-map', devServer: { contentBase: "./public",//本地服务器所加载的页面所在的目录 historyApiFallback: true,//不跳转 inline: true//实时刷新 }, module: { rules: [ { test: /(\.jsx|\.js)$/, use: { loader: "babel-loader", options: { presets: [ "env", "react" ] } }, exclude: /node_modules/ } ] } };
如今webpack的配置已经容许使用ES6以及JSX的语法了。继续用上面的例子进行测试,不过此次会使用React,要安装 React 和 React-DOM
npm install --save react react-dom
接下来使用ES6的语法,更新Greeter.js并返回一个React组件
//Greeter,js import React, {Component} from 'react' import config from './config.json'; class Greeter extends Component{ render() { return ( <div> {config.greetText} </div> ); } } export default Greeter
修改main.js以下,使用ES6的模块定义和渲染Greeter模块
// main.js import React from 'react'; import {render} from 'react-dom'; import Greeter from './Greeter'; render(<Greeter />, document.getElementById('root'));
而后从新使用webpack打包
注:babel-loader版本太高可能报错(8及以上)
npm i babel-loader@7 -D
打包成功后打开index.html能够看到输出信息:Hi there and greetings from JSON!
Webpack有一个不可不说的优势,它把全部的文件都都当作模块处理,JavaScript代码,CSS和fonts以及图片等等经过合适的loader均可以被处理。
webpack提供两个工具处理样式表,css-loader 和 style-loader,两者处理的任务不一样,css-loader使你可以使用相似@import 和 url(...)的方法实现 require()的功能,style-loader将全部的计算后的样式加入页面中,两者组合在一块儿使你可以把样式表嵌入webpack打包后的JS文件中。
首先安装
//安装 npm install --save-dev style-loader css-loader
而后使用
//使用 module.exports = { ... module: { rules: [ { test: /(\.jsx|\.js)$/, use: { loader: "babel-loader" }, exclude: /node_modules/ }, { test: /\.css$/, use: [ { loader: "style-loader" }, { loader: "css-loader" } ] } ] } };
请注意这里对同一个文件引入多个loader的方法。
接下来,在app文件夹里建立一个名字为"main.css"的文件,对一些元素设置样式
/* main.css */ html { box-sizing: border-box; -ms-text-size-adjust: 100%; -webkit-text-size-adjust: 100%; } *, *:before, *:after { box-sizing: inherit; } body { margin: 0; font-family: 'Helvetica Neue', Helvetica, Arial, sans-serif; } h1, h2, h3, h4, h5, h6, p, ul { margin: 0; padding: 0; }
咱们这里例子中用到的webpack只有单一的入口,其它的模块须要经过 import, require, url等与入口文件创建其关联,为了让webpack能找到”main.css“文件,咱们把它导入”main.js “中,以下
//main.js import React from 'react'; import {render} from 'react-dom'; import Greeter from './Greeter'; import './main.css';//使用require导入css文件 render(<Greeter />, document.getElementById('root'));
一般状况下,css会和js打包到同一个文件中,并不会打包为一个单独的css文件,不过经过合适的配置webpack也能够把css打包为单独的文件的。
上面的代码说明webpack是怎么把css当作模块看待的,下面是一个更加真实的css模块实践。
在过去的一些年里,JavaScript经过一些新的语言特性,更好的工具以及更好的实践方法(好比说模块化)发展得很是迅速。模块使得开发者把复杂的代码转化为小的,干净的,依赖声明明确的单元,配合优化工具,依赖管理和加载管理能够自动完成。
不过前端的另一部分,CSS发展就相对慢一些,大多的样式表却依旧巨大且充满了全局类名,维护和修改都很是困难。
被称为CSS modules的技术意在把JS的模块化思想带入CSS中来,经过CSS模块,全部的类名,动画名默认都只做用于当前模块。Webpack对CSS模块化提供了很是好的支持,只须要在CSS loader中进行简单配置便可,而后就能够直接把CSS的类名传递到组件的代码中,这样作有效避免了全局污染。具体的代码以下
module.exports = { ... module: { rules: [ { test: /(\.jsx|\.js)$/, use: { loader: "babel-loader" }, exclude: /node_modules/ }, { test: /\.css$/, use: [ { loader: "style-loader" }, { loader: "css-loader", options: { modules: true, // 指定启用css modules localIdentName: '[name]__[local]--[hash:base64:5]' // 指定css的类名格式 } } ] } ] } };
在app文件夹下建立一个Greeter.css文件来进行一下测试
/* Greeter.css */ .root { background-color: #eee; padding: 10px; border: 3px solid #ccc; }
导入.root到Greeter.js中
import React, {Component} from 'react'; import config from './config.json'; import styles from './Greeter.css';//导入 class Greeter extends Component{ render() { return ( <div className={styles.root}> //使用cssModule添加类名的方法 {config.greetText} </div> ); } } export default Greeter
而后相同的类名也不会形成不一样组件之间的污染。CSS modules 也是一个很大的主题,有兴趣的话能够去其官方文档了解更多。
Sass 和 Less 之类的预处理器是对原生CSS的拓展,它们容许你使用相似于variables, nesting, mixins, inheritance等不存在于CSS中的特性来写CSS,CSS预处理器能够这些特殊类型的语句转化为浏览器可识别的CSS语句,你如今可能都已经熟悉了,在webpack里使用相关loaders进行配置就可使用了,如下是经常使用的CSS 处理loaders:
不过其实也存在一个CSS的处理平台-PostCSS,它能够帮助你的CSS实现更多的功能,在其官方文档可了解更多相关知识。
举例来讲如何使用PostCSS,咱们使用PostCSS来为CSS代码自动添加适应不一样浏览器的CSS前缀。
首先安装postcss-loader 和 autoprefixer(自动添加前缀的插件)
npm install --save-dev postcss-loader autoprefixer
接下来,在webpack配置文件中添加postcss-loader,在根目录新建postcss.config.js,并添加以下代码以后,从新使用npm start打包时,你写的css会自动根据Can i use里的数据添加不一样前缀了。
//webpack.config.js module.exports = { ... module: { rules: [ { test: /(\.jsx|\.js)$/, use: { loader: "babel-loader" }, exclude: /node_modules/ }, { test: /\.css$/, use: [ { loader: "style-loader" }, { loader: "css-loader", options: { modules: true } }, { loader: "postcss-loader" } ] } ] } }
// postcss.config.js module.exports = { plugins: [ require('autoprefixer') ] }
以上即是处理JS的Babel和处理CSS的PostCSS的基本用法,它们其实也是两个单独的平台,配合webpack能够很好的发挥它们的做用。接下来介绍Webpack中另外一个很是重要的功能-Plugins
插件(Plugins)是用来拓展Webpack功能的,它们会在整个构建过程当中生效,执行相关的任务。
Loaders和Plugins经常被弄混,可是他们实际上是彻底不一样的东西,能够这么来讲,loaders是在打包构建过程当中用来处理源文件的(JSX,Scss,Less..),一次处理一个,插件并不直接操做单个文件,它直接对整个构建过程其做用。
Webpack有不少内置插件,同时也有不少第三方插件,可让咱们完成更加丰富的功能。
要使用某个插件,咱们须要经过npm安装它,而后要作的就是在webpack配置中的plugins关键字部分添加该插件的一个实例(plugins是一个数组)继续上面的例子,咱们添加了一个给打包后代码添加版权声明的插件。
const webpack = require('webpack'); module.exports = { ... module: { rules: [ { test: /(\.jsx|\.js)$/, use: { loader: "babel-loader" }, exclude: /node_modules/ }, { test: /\.css$/, use: [ { loader: "style-loader" }, { loader: "css-loader", options: { modules: true } }, { loader: "postcss-loader" } ] } ] }, plugins: [ new webpack.BannerPlugin('版权全部,翻版必究') ], };
经过这个插件,打包后的JS文件都会有个版权声明
这就是webpack插件的基础用法了,下面给你们推荐几个经常使用的插件
这个插件的做用是依据一个简单的index.html模板,生成一个自动引用你打包后的JS文件的新index.html。这在每次生成的js文件名称不一样时很是有用(好比添加了hash值)。
npm install --save-dev html-webpack-plugin
这个插件自动完成了咱们以前手动作的一些事情,在正式使用以前须要对一直以来的项目结构作一些更改:
1.移除public文件夹,利用此插件,index.html文件会自动生成,此外CSS已经经过前面的操做打包到JS中了。
2.在app目录下,建立一个index.tmpl.html文件模板,这个模板包含title等必须元素,在编译过程当中,插件会依据此模板生成最终的html页面,会自动添加所依赖的 css, js,favicon等文件,index.tmpl.html中的模板源代码以下:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <title>Webpack Sample Project</title> </head> <body> <div id='root'> </div> </body> </html>
3.更新webpack的配置文件,方法同上,新建一个build文件夹用来存放最终的输出文件
const webpack = require('webpack'); const HtmlWebpackPlugin = require('html-webpack-plugin'); module.exports = { entry: __dirname + "/app/main.js",//已屡次说起的惟一入口文件 output: { path: __dirname + "/build", filename: "bundle.js" }, devtool: 'eval-source-map', devServer: { contentBase: "./public",//本地服务器所加载的页面所在的目录 historyApiFallback: true,//不跳转 inline: true//实时刷新 }, module: { rules: [ { test: /(\.jsx|\.js)$/, use: { loader: "babel-loader" }, exclude: /node_modules/ }, { test: /\.css$/, use: [ { loader: "style-loader" }, { loader: "css-loader", options: { modules: true } }, { loader: "postcss-loader" } ] } ] }, plugins: [ new webpack.BannerPlugin('版权全部,翻版必究'), new HtmlWebpackPlugin({ template: __dirname + "/app/index.tmpl.html"//new 一个这个插件的实例,并传入相关的参数 }) ], };
再次执行webpack你会发现,build文件夹下面生成了bundle.js和index.html。
Hot Module Replacement(HMR)也是webpack里颇有用的一个插件,它容许你在修改组件代码后,自动刷新实时预览修改后的效果。
在webpack中实现HMR也很简单,只须要作两项配置
1.在webpack配置文件中添加HMR插件;
2.在Webpack Dev Server中添加“hot”参数;
不过配置完这些后,JS模块其实仍是不能自动热加载的,还须要在你的JS模块中执行一个Webpack提供的API才能实现热加载,虽然这个API不难使用,可是若是是React模块,使用咱们已经熟悉的Babel能够更方便的实现功能热加载。
具体思路以下
具体配置以下
const webpack = require('webpack'); const HtmlWebpackPlugin = require('html-webpack-plugin'); module.exports = { entry: __dirname + "/app/main.js",//已屡次说起的惟一入口文件 output: { path: __dirname + "/build", filename: "bundle.js" }, devtool: 'eval-source-map', devServer: { contentBase: "./public",//本地服务器所加载的页面所在的目录 historyApiFallback: true,//不跳转 inline: true, hot: true }, module: { rules: [ { test: /(\.jsx|\.js)$/, use: { loader: "babel-loader" }, exclude: /node_modules/ }, { test: /\.css$/, use: [ { loader: "style-loader" }, { loader: "css-loader", options: { modules: true } }, { loader: "postcss-loader" } ] } ] }, plugins: [ new webpack.BannerPlugin('版权全部,翻版必究'), new HtmlWebpackPlugin({ template: __dirname + "/app/index.tmpl.html"//new 一个这个插件的实例,并传入相关的参数 }), new webpack.HotModuleReplacementPlugin()//热加载插件 ], };
安装react-transform-hmr
npm install --save-dev babel-plugin-react-transform react-transform-hmr
配置Babel
// .babelrc { "presets": ["react", "env"], "env": { "development": { "plugins": [["react-transform", { "transforms": [{ "transform": "react-transform-hmr", "imports": ["react"], "locals": ["module"] }] }]] } } }
如今当使用React时,能够热加载模块了,每次保存就能在浏览器上看到更新内容。
在产品阶段,可能须要对打包的文件进行额外的处理,好比说优化,压缩,缓存以及分离CSS和JS。
对于复杂的项目来讲,须要复杂的配置,这时候分解配置文件为多个小的文件可使得事情层次分明,以上面的例子来讲,咱们建立一个webpack.production.config.js的文件,在里面加上基本的配置,它和原始的webpack.config.js很像,以下
// webpack.production.config.js const webpack = require('webpack'); const HtmlWebpackPlugin = require('html-webpack-plugin'); module.exports = { entry: __dirname + "/app/main.js", //已屡次说起的惟一入口文件 output: { path: __dirname + "/build", filename: "bundle.js" }, devtool: 'null', //注意修改了这里,这能大大压缩咱们的打包代码 devServer: { contentBase: "./public", //本地服务器所加载的页面所在的目录 historyApiFallback: true, //不跳转 inline: true, hot: true }, module: { rules: [{ test: /(\.jsx|\.js)$/, use: { loader: "babel-loader" }, exclude: /node_modules/ }, { test: /\.css$/, use: ExtractTextPlugin.extract({ fallback: "style-loader", use: [{ loader: "css-loader", options: { modules: true } }, { loader: "postcss-loader" }], }) }] }, plugins: [ new webpack.BannerPlugin('版权全部,翻版必究'), new HtmlWebpackPlugin({ template: __dirname + "/app/index.tmpl.html" //new 一个这个插件的实例,并传入相关的参数 }), new webpack.HotModuleReplacementPlugin() //热加载插件 ], };
//package.json { "name": "test", "version": "1.0.0", "description": "", "main": "index.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1", "start": "webpack", "server": "webpack-dev-server --open", "build": "NODE_ENV=production webpack --config ./webpack.production.config.js --progress" }, "author": "", "license": "ISC", "devDependencies": { ... }, "dependencies": { "react": "^15.6.1", "react-dom": "^15.6.1" } }
注意:若是是windows电脑,build须要配置为"build": "set NODE_ENV=production && webpack --config ./webpack.production.config.js --progress"
webpack提供了一些在发布阶段很是有用的优化插件,它们大多来自于webpack社区,能够经过npm安装,经过如下插件能够完成产品发布阶段所需的功能
继续用例子来看看如何添加它们,OccurenceOrder 和 UglifyJS plugins 都是内置插件,须要作的只是安装其它非内置插件
npm install --save-dev extract-text-webpack-plugin
在配置文件的plugins后引用它们
// webpack.production.config.js const webpack = require('webpack'); const HtmlWebpackPlugin = require('html-webpack-plugin'); const ExtractTextPlugin = require('extract-text-webpack-plugin'); module.exports = { entry: __dirname + "/app/main.js",//已屡次说起的惟一入口文件 output: { path: __dirname + "/build", filename: "bundle.js" }, devtool: 'none', devServer: { contentBase: "./public",//本地服务器所加载的页面所在的目录 historyApiFallback: true,//不跳转 inline: true, hot: true }, module: { rules: [ { test: /(\.jsx|\.js)$/, use: { loader: "babel-loader" }, exclude: /node_modules/ }, { test: /\.css$/, use: [ { loader: "style-loader" }, { loader: "css-loader", options: { modules: true } }, { loader: "postcss-loader" } ] } ] }, plugins: [ new webpack.BannerPlugin('版权全部,翻版必究'), new HtmlWebpackPlugin({ template: __dirname + "/app/index.tmpl.html" }), new webpack.optimize.OccurrenceOrderPlugin(), new webpack.optimize.UglifyJsPlugin(), new ExtractTextPlugin("style.css") ], };
此时执行npm run build能够看见代码是被压缩后的
缓存无处不在,使用缓存的最好方法是保证你的文件名和文件内容是匹配的(内容改变,名称相应改变)
webpack能够把一个哈希值添加到打包的文件名中,使用方法以下,添加特殊的字符串混合体([name], [id] and [hash])到输出文件名前
const webpack = require('webpack'); const HtmlWebpackPlugin = require('html-webpack-plugin'); const ExtractTextPlugin = require('extract-text-webpack-plugin'); module.exports = { .. output: { path: __dirname + "/build", filename: "bundle-[hash].js" }, ... };
如今用户会有合理的缓存了
添加了hash以后,会致使改变文件内容后从新打包时,文件名不一样而内容愈来愈多,所以这里介绍另一个很好用的插件clean-webpack-plugin。
npm install clean-webpack-plugin --save-dev
引入clean-webpack-plugin插件后在配置文件的plugins中作相应配置便可:
const CleanWebpackPlugin = require("clean-webpack-plugin"); plugins: [ ...// 这里是以前配置的其它各类插件 new CleanWebpackPlugin('build/*.*', { root: __dirname, verbose: true, dry: false }) ]
关于clean-webpack-plugin的详细使用可参考这里
开发老是离不开调试,方便的调试能极大的提升开发效率,不过有时候经过打包后的文件,你是不容易找到出错了的地方,对应的你写的代码的位置的,Source Maps就是来帮咱们解决这个问题的。
经过简单的配置,webpack就能够在打包时为咱们生成的source maps,这为咱们提供了一种对应编译文件和源文件的方法,使得编译后的代码可读性更高,也更容易调试。
在webpack的配置文件中配置source maps,须要配置devtool,它有如下四种不一样的配置选项,各具优缺点,描述以下:
devtool选项 | 配置结果 |
---|---|
source-map | 在一个单独的文件中产生一个完整且功能彻底的文件。这个文件具备最好的source map,可是它会减慢打包速度 |
cheap-module-source-map | 在一个单独的文件中生成一个不带列映射的map,不带列映射提升了打包速度,可是也使得浏览器开发者工具只能对应到具体的行,不能对应到具体的列(符号),会对调试形成不便 |
cheap-module-eval-source-map | 这是在打包文件时最快的生成source map的方法,生成的Source Map 会和打包后的JavaScript文件同行显示,没有列映射,和eval-source-map选项具备类似的缺点 |
eval-source-map | 使用eval打包源文件模块,在同一个文件中生成干净的完整的source map。这个选项能够在不影响构建速度的前提下生成完整的sourcemap,可是对打包后输出的JS文件的执行具备性能和安全的隐患。在开发阶段这是一个很是好的选项,在生产阶段则必定不要启用这个选项 |
正如上表所述,上述选项由上到下打包速度愈来愈快,不过同时也具备愈来愈多的负面做用,较快的打包速度的后果就是对打包后的文件的的执行有必定影响。
对小到中型的项目中,eval-source-map是一个很好的选项,再次强调你只应该开发阶段使用它,咱们继续对上文新建的webpack.config.js,进行以下配置:
module.exports = { devtool: 'eval-source-map', entry: __dirname + "/app/main.js", output: { path: __dirname + "/public", filename: "bundle.js" } }
cheap-module-eval-source-map方法构建速度更快,可是不利于调试,推荐在大型项目考虑时间成本时使用。
想不想让你的浏览器监听你的代码的修改,并自动刷新显示修改后的结果,其实Webpack提供一个可选的本地开发服务器,这个本地服务器基于node.js构建,能够实现你想要的这些功能,不过它是一个单独的组件,在webpack中进行配置以前须要单独安装它做为项目依赖
npm install --save-dev webpack-dev-server
devserver做为webpack配置选项中的一项,如下是它的一些配置选项,更多配置可参考这里
devserver的配置选项 | 功能描述 |
---|---|
contentBase | 默认webpack-dev-server会为根文件夹提供本地服务器,若是想为另一个目录下的文件提供本地服务器,应该在这里设置其所在目录(本例设置到“public"目录) |
port | 设置默认监听端口,若是省略,默认为”8080“ |
inline | 设置为true,当源文件改变时会自动刷新页面 |
historyApiFallback | 在开发单页应用时很是有用,它依赖于HTML5 history API,若是设置为true,全部的跳转将指向index.html |
把这些命令加到webpack的配置文件中,如今的配置文件webpack.config.js以下所示
module.exports = { devtool: 'eval-source-map', entry: __dirname + "/app/main.js", output: { path: __dirname + "/public", filename: "bundle.js" }, devServer: { contentBase: "./public",//本地服务器所加载的页面所在的目录 historyApiFallback: true,//不跳转 inline: true//实时刷新 } }
在package.json中的scripts对象中添加以下命令,用以开启本地服务器:
"scripts": { "test": "echo \"Error: no test specified\" && exit 1", "start": "webpack", "server": "webpack-dev-server --open" },
在终端中输入npm run server便可在本地的8080端口查看结果。