Webpack笔记 Webpack笔记

通过命令行使用Webpack $ sudo npm install -g webpack //全局安装
$ cd /Users/lirui/Desktop/webpack //进到你的项目目录
$ npm install --save-dev webpack // 安装Webpack到你的项目目录
$ npm init //创建package.json配置文件，一直回车即可

Press ^C at any time to quit. package name: (webpack) version: (1.0.0) description: entry point: (webpack.js) test command: git repository: keywords: author: license: (ISC) About to write to /Users/lirui/Desktop/webpack/package.json:{ "name": "webpack", "version": "1.0.0", "description": "", "main": "webpack.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1" }, "author": "", "license": "ISC" } Is this ok? (yes) yes

方法一：
找到package.json，添加下面的两条内容，这是因为webpack --mode development太长了，你每次想默认打包，你需要输入好多（有开发模式和生产模式两种），就给起个别名，如下图进行配置：

{ "name": "webpack1", "version": "1.0.0", "description": "", "main": "index.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1", "dev": "webpack --mode development", "build": "webpack --mode production" }, "author": "", "license": "ISC" }

$ npm run dev (开发环境输出的main.js没有压缩)
或者
$ npm run build (生产模式输出的main.js压缩过）
说明：webpack --mode开发就会以默认路径进行打包，入口文件是./src/index.js。我们生成的文件，是没有src这个文件夹的，这时候需要手动创建，并且在src文件夹中新建一个index.js文件。
这样通过命令：$ npm run dev 或者 $ npm run build 就会把index.js文件打包成默认的dist文件夹中的main.js
方法二：
$ webpack app/main.js -o public/bundle.js //指定入口文件和输出文件
// webpack非全局安装的情况:
//$ node_modules/.bin/webpack app/main.js -o public/bundle.js
通过配置文件来使用Webpack($ webpack(非全局安装需使用node_modules/.bin/webpack)) 在当前项目根目录下新建一个名为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 文件中的配置选项。
更快捷的执行打包任务($ npm start) 在命令行中输入命令需要代码类似于 node_modules/.bin/webpack 这样的路径其实是比较烦人的，不过值得庆幸的是npm可以引导任务执行，对npm进行配置后可以在命令行中使用简单的 npm start 命令来替代上面略微繁琐的命令。在package.json中对scripts对象进行相关设置即可，设置方法如下:

{ "name": "webpack3", "version": "1.0.0", "description": "", "main": "webpack.config.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1", "start": "webpack" }, "author": "", "license": "ISC" }

注：package.json中的script会安装一定顺序寻找命令对应位置，本地的node_modules/.bin路径就在这个寻找清单中，所以无论是全局还是局部安装的Webpack，你都不需要写前面那指明详细的路径了。
npm的start命令是一个特殊的脚本名称，其特殊性表现在，在命令行中使用 npm start 就可以执行其对于的命令，如果对应的此脚本名称不是start，想要在命令行中运行时，需要这样用 npm run {script name} 如 npm run build，我们在命令行中输入 $ npm start 就可以打包了。
Webpack的强大功能 1. 生成Source Maps(使调试更容易) 通过简单的配置，webpack就可以在打包时为我们生成的source maps，这为我们提供了一种对应编译文件和源文件的方法，使得编译后的代码可读性更高，也更容易调试。
在webpack的配置文件中配置source maps，需要配置devtool，它有以下四种不同的配置选项，各具优缺点，描述如下：

source-map
在一个单独的文件中产生一个完整且功能完全的文件。这个文件具有最好的 source map，但是它会减慢打包速度；
cheap-module-source-map
在一个单独的文件中生成一个不带列映射的map，不带列映射提高了打包速度，但是也使得浏览器开发者工具只能对应到具体的行，不能对应到具体的列（符号），会对调试造成不便；
eval-source-map
使用eval打包源文件模块，在同一个文件中生成干净的完整的source map。这个选项可以在不影响构建速度的前提下生成完整的sourcemap，但是对打包后输出的JS文件的执行具有性能和安全的隐患。在开发阶段这是一个非常好的选项，在生产阶段则一定不要启用这个选项；
cheap-module-eval-source-map
这是在打包文件时最快的生成source map的方法，生成的Source Map 会和打包后的JavaScript文件同行显示，没有列映射，和eval-source-map选项具有相似的缺点；

上述选项由上到下打包速度越来越快，不过同时也具有越来越多的负面作用，较快的打包速度的后果就是对打包后的文件的的执行有一定影响。
对小到中型的项目中，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方法构建速度更快，但是不利于调试，推荐在大型项目考虑时间成本时使用。

文章图片
设置source-map之前

文章图片
设置source-map之后 2. 使用webpack构建本地服务器想不想让你的浏览器监听你的代码的修改，并自动刷新显示修改后的结果，其实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
colors
设置为true,使终端输出的文件为彩色的
hot:true
允许热加载

把这些命令加到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端口查看结果:

文章图片
开启本地服务器.png Loaders Loaders是webpack提供的最激动人心的功能之一了。通过使用不同的loader，webpack有能力调用外部的脚本或工具，实现对不同格式的文件的处理，比如说分析转换scss为css，或者把下一代的JS文件（ES6，ES7)转换为现代浏览器兼容的JS文件，对React的开发而言，合适的Loaders可以把React的中用到的JSX文件转换为JS文件。
Loaders需要单独安装并且需要在webpack.config.js中的modules关键字下进行配置，Loaders的配置包括以下几方面：

test：一个用以匹配loaders所处理文件的拓展名的正则表达式（必须）
loader：loader的名称（必须）
include/exclude:手动添加必须处理的文件（文件夹）或屏蔽不需要处理的文件（文件夹）（可选）；
query：为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 Babel其实是一个编译JavaScript的平台，它可以编译代码帮你达到以下目的：

让你能使用最新的JavaScript代码（ES6，ES7...），而不用管新标准是否被当前使用的浏览器完全支持；
让你能使用基于JavaScript进行了拓展的语言，比如React的JSX；

1. Babel的安装与配置 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.config.js 中配置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 ({config.greetText}); } }export default Greeter

修改 main.js 如下，使用ES6的模块定义和渲染Greeter模块:

// main.js import React from 'react'; import {render} from 'react-dom'; import Greeter from './Greeter.js'; render(, document.getElementById('root'));

重新使用 npm start 打包，如果之前打开的本地服务器没有关闭，你应该可以在 localhost:8080 下看到与之前一样的内容，这说明 react 和 es6 被正常打包了。

文章图片
localhost:8080 2. Babel的配置 Babel其实可以完全在 webpack.config.js 中进行配置，但是考虑到babel具有非常多的配置选项，在单一的webpack.config.js文件中进行配置往往使得这个文件显得太复杂，因此一些开发者支持把babel的配置选项放在一个单独的名为 ".babelrc" 的配置文件中。我们现在的babel的配置并不算复杂，不过之后我们会再加一些东西，因此现在我们就提取出相关部分，分两个配置文件进行配置（webpack会自动调用.babelrc里的babel配置选项），如下：

//webpack.config.js 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" }, exclude: /node_modules/ } ] } };

//.babelrc { "presets": ["react", "env"] }

到目前为止，我们已经知道了，对于模块，Webpack能提供非常强大的处理功能，那那些是模块呢。
一切皆模块 Webpack有一个不可不说的优点，它把所有的文件都都当做模块处理，JavaScript代码，CSS和fonts以及图片等等通过合适的loader都可以被处理。
CSS webpack提供两个工具处理样式表，css-loader 和 style-loader，二者处理的任务不同，
css-loader 使你能够使用类似 @import 和 url(...) 的方法实现 require()的功能,
style-loader将所有的计算后的样式加入页面中，
二者组合在一起使你能够把样式表嵌入webpack打包后的JS文件中。
继续上面的例子

//安装 npm install --save-dev style-loader css-loader

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" }, 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.js'; import './main.css'; //使用require导入css文件render(, document.getElementById('root'));

通常情况下，css会和js打包到同一个文件中，并不会打包为一个单独的css文件，不过通过合适的配置webpack也可以把css打包为单独的文件的。

上面的代码说明webpack是怎么把css当做模块看待的，咱们继续看一个更加真实的css模块实践。
CSS module 在过去的一些年里，JavaScript通过一些新的语言特性，更好的工具以及更好的实践方法（比如说模块化）发展得非常迅速。模块使得开发者把复杂的代码转化为小的，干净的，依赖声明明确的单元，配合优化工具，依赖管理和加载管理可以自动完成。
不过前端的另外一部分，CSS发展就相对慢一些，大多的样式表却依旧巨大且充满了全局类名，维护和修改都非常困难。
被称为CSS modules的技术意在把JS的模块化思想带入CSS中来，通过CSS模块，所有的类名，动画名默认都只作用于当前模块。Webpack对CSS模块化提供了非常好的支持，只需要在CSS loader中进行简单配置即可，然后就可以直接把CSS的类名传递到组件的代码中，这样做有效避免了全局污染。具体的代码如下

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" }, exclude: /node_modules/ }, { test: /\.css$/, use: [ { loader: "style-loader" }, { loader: "css-loader", options: { modules: true, //指定启用css modules localIdentName: '[name]__[local]--[hash:base64:5]' // 指定css的类名格式 } }] } ] } };

【Webpack笔记】我们在app文件夹下创建一个 Greeter.css 文件来进行一下测试:

/* Greeter.css */ .root { background-color: #eee; padding: 10px; border: 3px solid #ccc; }

导入.root到Greeter.js中

//Greeter,js import React, {Component} from 'react'; import config from '../config.json'; import styles from './Greeter.css'; //导入class Greeter extends Component { render() { return ( //使用cssModule添加类名的方法{config.greetText}); } }export default Greeter

放心使用吧，相同的类名也不会造成不同组件之间的污染。