webpack4.x学习笔记
有输入必须有输出,今天就来输出一下学习webpack的过程。
不得不先吐槽一下,比起可爱的grunt和好用的gulp,对webpack真心爱不起来!
还有一个血的教训:千万不要偷懒,有问题直接去官网。。。
本文旨在记录学习webpack的过车和遇到的问题,适合对node和webpack基础知识有些了解的开发人员,不会详细到记录操作命令;还有些问题无解,还请高手指教。
首先贴上搭建时候各种包的版本,毕竟webpack每次升级兼容性都不太好
操作系统:windows 10;node:v8.9.4

搭建步骤
1、安装webpack,webpack-cli,webpack-dev-server html-webpack-server (webpack-cli在4.x的版本中已经被抽离,这里需要再安装一下);
对应配置:
a、在package.json的scripts中配置启动server的命令。

b、在webpack.config.js中配置入口,出口,以及server;
有关server的更多配置参数请参考 https://webpack.js.org/configuration/dev-server/#src/components/Sidebar/Sidebar.jsx
c、配置html-webpack-plugin,在编译后的文件夹自动生成一个html,并且已经添加了编译后的入口js;
配置后webpack.config.js:(这时候我们就可以直接用 npm run dev 来启动服务了。)
const webpack = require('webpack');
const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
module.exports = {
entry:{//入口文件,这里可以配置多个入口
main: path.resolve(__dirname,'src/module/index/main.js'),
//plugin: path.resolve(__dirname,'src/plugin/plugin.js')
},
output: {//打包后文件位置以及文件名
path: path.resolve(__dirname,'dist'),
filename: '[name].js'
},
devServer: {//server配置
contentBase: path.join(__dirname,"dist"), //服务指向的文件夹
port: 9000,//端口号
inline: true,//自动刷新模式配置为inline
open: true, //是否自动打开页面
proxy: { //代理配置
"/dist": {
target: "http://localhost:3000",
pathRewrite: {
"^/api": ""
},
bypass: function(req, res, proxyOptions){
//代理过滤函数
return ""
}
}
}
},
plugins: [
new HtmlWebpackPlugin({
//配置生成新html的源html
template: path.resolve(__dirname,'src/index.html')
})
]
}
2、配置loader
a、安装js处理包:babel-loader babel-ccore babel-preset-env并配置
babel-preset-env 可以根据配置的env只编译那些还不支持的特性,详情请参考https://github.com/babel/babel-preset-env
{ test: /\.js$/, use: { loader: 'babel-loader', options: { presets: ['env'], cacheDirectory: true //配置允许缓存,加快编译速度 } } }
b、安装css处理包 node-sass sass-loader(代码中使用sass,less的配置跟sass一样,只要安装less对应的处理插件即可)
安装css分离处理插件 extract-webpack-text-plugin,把css样式从html页面摘出来放到单独的文件中
sass-loader 依赖于 node-sass,所以这里不要忘记安装 node-sass;
首先引入extract-webpack-text-plugin,并new出两个对象来,分别处理css和less,传参为处理后样式的保存路径:
const ExtractTextPlugin = require("extract-text-webpack-plugin");
const extractCss = new ExtractTextPlugin('css/[name].css');
const extractLess = new ExtractTextPlugin('css/[name].css');
module中配置loader的rules:
{ test: /\.scss$/, use: extractLess.extract(["css-loader","sass-loader"]) }, { test: /\.css$/, use: extractCss.extract({ fallback: "style-loader", use: "css-loader" }) },
plugins里添加extractCss和extractLess插件:
plugins: [ new HtmlWebpackPlugin({ template: path.resolve(__dirname,'src/index.html') }), extractCss, extractLess ]
c、img,字体等文件loader安装配置 url-loader file-loader
注意:文档里介绍url-loader是基于file-loader封装的支持更多配置的loader,但是经测试发现,url-loader并不能单独使用,需要同时安装file-loader才可
哪位同学如果知道原因还请留言,先感谢!
{//加载图片loader配置
test: /\.(png|jpg|gif)$/,
use: [
{
loader: 'url-loader',
options: {
limit: 8192 //大小限制
}
}
]
},
{//加载字体等loader配置
test: /\.(eot|svg|ttf|woff|woff2)(\?\S*)?$/,
use:{
loader: 'file-loader'
}
}
3、其他插件配置
uglifyJsPlugin,这个插件在4.x的版本中,也已经被独立出来,需要单独安装才能使用。
关于模块热加载的开启,官方文档中给出多种实现,这里给出使用devServer实现方式的测试:
其他实现方式详情参考 https://doc.webpack-china.org/guides/hot-module-replacement
在devServer 中设置 hot: true,在plugins中添加webpack.HotModuleReplacementPlugin();
测试结果:
修改html文件:浏览器打出HMR字样的提示,但是页面并没有变化:

修改js文件:编译后页面完全刷新;
当我打算继续配置多入口多页面时,竟然发现我只能循环调用 html-webpack-plugin来生成html;
到目前位置,webpack给我的感觉就是编译速度慢,文档介绍不清晰以至于奇奇怪怪的bug一个又一个,这些感受大概是因为学习不够深入,不够细致。
最后,贴出package.json和webpack.config.js
{ "name": "webpackOnly", "version": "1.0.0", "description": "", "main": "index.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1", "dev": "webpack-dev-server" }, "keywords": [], "author": "", "license": "ISC", "devDependencies": { "babel-core": "^6.26.0", "babel-loader": "^7.1.4", "babel-preset-env": "^1.6.1", "css-loader": "^0.28.11", "extract-text-webpack-plugin": "^4.0.0-beta.0", "file-loader": "^1.1.11", "html-webpack-plugin": "^3.2.0", "node-sass": "^4.8.3", "sass-loader": "^7.0.1", "style-loader": "^0.21.0", "uglifyjs-webpack-plugin": "^1.2.5", "url-loader": "^1.0.1", "webpack": "^4.6.0", "webpack-cli": "^2.0.15", "webpack-dev-server": "^3.1.3" }, "dependencies": { "element-ui": "^2.3.6" } }
const webpack = require('webpack');
const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const UglifyJsPlugin = require('uglifyjs-webpack-plugin');
const ExtractTextPlugin = require("extract-text-webpack-plugin");
const extractCss = new ExtractTextPlugin('css/[name].css');
const extractLess = new ExtractTextPlugin('css/[name].css');
module.exports = {
entry:{//入口文件,这里可以配置多个入口
main: path.resolve(__dirname,'src/module/index/main.js'),
plugin: path.resolve(__dirname,'src/plugin/plugin.js')
},
output: {//打包后文件位置以及文件名
path: path.resolve(__dirname,'dist'),
filename: '[name].js'
},
devServer: {//server配置
contentBase: path.join(__dirname,"dist"), //服务指向的文件夹
port: 9000,//端口号
inline: true,//自动刷新模式配置为inline
open: true, //是否自动打开页面
hot: true,
proxy: { //代理配置
"/dist": {
target: "http://localhost:3000",
pathRewrite: {
"^/api": ""
},
bypass: function(req, res, proxyOptions){
//代理过滤函数
return ""
}
}
}
},
plugins: [
new HtmlWebpackPlugin({
template: path.resolve(__dirname,'src/index.html')
}),
new UglifyJsPlugin({
uglifyOptions: {
compress: false
}
}),
new webpack.HotModuleReplacementPlugin(),//热加载插件
extractCss,
extractLess
],
module: {
rules: [
{
test: /\.js$/,
use: {
loader: 'babel-loader',
options: {
presets: ['env'],
cacheDirectory: true //配置允许缓存,加快编译速度
}
}
},
{
test: /\.scss$/,
use: extractLess.extract(["css-loader","sass-loader"])
/*use: [{ //不使用css抽离的配置方式
loader: 'style-loader'
},{
loader: 'css-loader'
},{
loader: 'sass-loader',
options: {
includePaths: ["src"]
}
}]*/
},
{
test: /\.css$/,
use: extractCss.extract({
fallback: "style-loader",
use: "css-loader"
})
},
{
test: /\.(png|jpg|gif)$/,
use: [
{
loader: 'url-loader',
options: {
limit: 8192
}
}
]
},
{
test: /\.(eot|svg|ttf|woff|woff2)(\?\S*)?$/,
use:{
loader: 'file-loader'
}
}
]
}
}

浙公网安备 33010602011771号