webpack.dev.conf.js详解
转载自：https://www.cnblogs.com/ye-hcj/p/7087205.html
//引入当前目录下的utils.js文件模块
var utils = require('./utils')
//node的path模块
var path = require('path')
//内置模块
var webpack = require('webpack')
//引入config目录下的index.js文件
var config = require('../config')
//进行合并对象，相同项目会进行覆盖
var merge = require('webpack-merge')
var baseWebpackConfig = require('./webpack.base.conf')
// 下面是一个自动生成html的插件，能够把资源自动加载到html文件中
// 详情请看 (1）
var HtmlWebpackPlugin = require('html-webpack-plugin')
// 下面这个插件是用来把webpack的错误和日志收集起来，漂亮的展示给用户
// 详情请看 (2)
var FriendlyErrorsPlugin = require('friendly-errors-webpack-plugin')
//=======================静态编译ssi资源==================================
var SSICompileWebpackPlugin = require('ssi-webpack-plugin')
// add hot-reload related code to entry chunks// Object.keys(obj) Object.keys() 方法会返回一个由一个给定对象的自身可枚举属性组成的数组，//数组中属性名的排列顺序和使用 for...in 循环遍历该对象时返回的顺序一致 （两者的主要区别是 一个 for-in 循环还会枚举其原型链上的属性）。
Object.keys(baseWebpackConfig.entry).forEach(function (name) {// 下面这个结果就是把webpack.base.conf.js中的入口entry改成如下配置 // app: ['./build/dev-client','./src/main.js'] //即数组多加了一个元素
baseWebpackConfig.entry[name] = ['./build/dev-client'].concat(baseWebpackConfig.entry[name])
})
// 下面是合并配置对象，将这个配置文件特有的配置添加替换到base配置文件中
module.exports = merge(baseWebpackConfig, {
module: { // 下面是把utils配置中的处理css类似文件的处理方法拿过来，并且不生成cssMap文件
rules: utils.styleLoaders({ sourceMap: config.dev.cssSourceMap })
},
// cheap-module-eval-source-map is faster for development// devtool是开发工具选项，用来指定如何生成sourcemap文件，cheap-module-eval-source-map此款soucemap文件性价比最高
devtool: '#source-map',
plugins: [// DefinePlugin内置webpack插件，专门用来定义全局变量的，下面定义一个全局变量 process.env 并且值是如下 /* 'process.env': { NODE_ENV: '"development"' } 这样的形式会被自动转为 'process.env': '"development"' 各位骚年看好了，development如果不加双引号就当做变量处理，程序会报错 */
new webpack.DefinePlugin({
'process.env': config.dev.env
}),
//提取公共代码块 babel-polyfill只能有一个实例
new webpack.optimize.CommonsChunkPlugin({
name: 'vendor',
chunks: ['index', 'admin'],
minChunks: function (module, count) {
return (
module.resource &&
/\.js$/.test(module.resource) &&
module.resource.indexOf(
path.join(__dirname, '../node_modules')
) === 0
)
}
}),
// https://github.com/glenjamin/webpack-hot-middleware#installation--usage
new webpack.HotModuleReplacementPlugin(),// 下面这个插件比较简单，就是当webpack编译错误的时候，来中端打包进程，防止错误代码打包到文件中，你还不知道
new webpack.NoEmitOnErrorsPlugin(),
// https://github.com/ampedandwired/html-webpack-plugin
new HtmlWebpackPlugin({
filename: 'index.html',
template: 'index.html',
favicon: './src/assets/images/favicon.ico',
excludeChunks: ['admin'],
inject: true
}),
new HtmlWebpackPlugin({
filename: 'admin.html',
template: 'admin.html',
favicon: './src/assets/images/favicon.ico',
excludeChunks: ['index'],
inject: true
}),
new SSICompileWebpackPlugin({
publicPath:'',
localBaseDir:'C:/Developer/newWorkspace',
minify:false
}),
new FriendlyErrorsPlugin()
]
})
(1)html-webpack-plugin插件是用来生成html文件的，有很灵活的配置项，下面是基本的一些用法
plugins: [
new HtmlWebpackPlugin(), // Generates default index.html
new HtmlWebpackPlugin({ // Also generate a test.html
filename: 'test.html', // 生成的文件的名称
title: 'Custom template', // 文件的标题
template: 'my-index.ejs' //可以指定模块html文件
})
]
下面是模板文件my-index.ejs的内容
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-type" content="text/html; charset=utf-8"/>
<title><%= htmlWebpackPlugin.options.title %></title> //这里使用特殊的表示插入配置项的title
</head>
<body>
</body>
</html>
(2)friendly-errors-webpack-plugin插件，把webpack编译出来的错误展示给我们，方便调试
安装 npm install friendly-errors-webpack-plugin --save-dev
基本使用
plugins: [
new FriendlyErrorsWebpackPlugin(),
]
注意点，使用这个插件要遵守下点
您需要关闭所有的错误日志记录，将webpack配置静默选项设置为true
也就是遵循以下三点即可
在使用webpack-dev-middleware插件，关于这个插件的解释在我的dev-sever-js配置文件中有解释，设置以下内容
app.use(require('webpack-dev-middleware')(compiler, {
quiet: true, // 必须设置
publicPath: config.output.publicPath,
}));
使用webpack-dev-server时设置如下
{
devServer: {
quiet: true
}
}
使用webpack-hot-middleware中间件，关于这个插件的解释也在我的dev-server-js文章中
app.use(require('webpack-hot-middleware')(compiler, {
log: () => {}
}));
做到以上几点，就可以正常使用这个插件了，这个插件还有一些配置项，感兴趣自行了解
(3) HotModuleReplacementPlugin解释如下
老哥们知道什么是webpack模块不
webpack支持如下模块
CoffeeScript
TypeScript
ESNext (Babel)
Sass
Less
Stylus
这些模块支持如下导入的方式
ES2015 import 语句
CommonJS require() 语句
AMD define 和 require 语句
css/sass/less 文件中的 @import 语句。
样式(url(...))或 HTML 文件(<img src=...>)中的图片链接(image url)
看到了把，webpack就是这么强大，几乎囊括了前端所有的东西
这个插件的作用就是当你的程序在运行时，而你现在要替换、添加或删除某个模块，又不想重新加载页面，
这个插件帮助你实现无刷新加载，关于内部实现原理，其实有点意思，各位请自行查看
