1、webpack的安裝
本教程是基于最新的webpack4.39.3 版本
注意:webpack是基于node的,所以使用前請(qǐng)先自行安裝nodejs環(huán)境
-
全局安裝webpack(不推薦)
npm i webpack webpack-cli -g -
項(xiàng)目中安裝webpack (推薦)
新建一個(gè)空文件,然后初始化
npm init -y初始化一個(gè)package.json文件然后去下載
npm i webpack webpack-cli -D
2、webpack的使用
①.webpack-cli
npm 5.2 以上的版本中提供了一個(gè)npx命令
npx 想要解決的主要問(wèn)題,就是調(diào)用項(xiàng)目?jī)?nèi)部安裝的模塊,原理就是在node_modules下的.bin 目錄中找到對(duì)應(yīng)的命令執(zhí)行
使用webpack命令:npx webpack
webpack4.0之后可以實(shí)現(xiàn)0配置打包構(gòu)建,0配置的特點(diǎn)就是限制較多,無(wú)法自定義很多配置,默認(rèn)打包./src/index.js文件,默認(rèn)打包到./dist文件夾下
開(kāi)發(fā)中常用的還是使用webpack配置進(jìn)行打包構(gòu)建
②.webpack配置
webpack有四大核心概念:
入口(entry): 程序的入口js
輸出(output): 打包后存放的位置
loader: 用于對(duì)模塊的源代碼進(jìn)行轉(zhuǎn)換
插件(plugins): 插件目的在于解決 loader無(wú)法實(shí)現(xiàn)的其他事
配置webpack.config.js
運(yùn)行
npx webpack會(huì)自動(dòng)加載當(dāng)前目錄內(nèi)的webpack.config.js文件,或者可以在package.json文件的script腳本內(nèi)配置"build":"webpack":然后使用npm run build即可打包- 按照指定文件打包的話需要配置
webpack --config xxx.config.js
- 按照指定文件打包的話需要配置
const path = require('path')
module.exports = {
// 入口文件配置
entry: './src/index.js',
// 出口文件配置項(xiàng)
output: {
// 輸出的路徑,webpack2起就規(guī)定必須是絕對(duì)路徑
path: path.join(__dirname, 'dist'),
// 輸出文件名字
filename: 'bundle.js'
},
mode: 'development' // 默認(rèn)為production, 可以手動(dòng)設(shè)置為development, 區(qū)別就是是否進(jìn)行壓縮混淆
}
③.開(kāi)發(fā)時(shí)自動(dòng)編譯工具
每次要編譯代碼時(shí),手動(dòng)運(yùn)行 npm run build 就會(huì)變得很麻煩。
webpack 中有幾個(gè)不同的選項(xiàng),可以幫助你在代碼發(fā)生變化后自動(dòng)編譯代碼:
webpack's Watch Mode
webpack-dev-server
webpack-dev-middleware
watch
在webpack指令后面加上--watch參數(shù)即可
主要的作用就是監(jiān)視本地項(xiàng)目文件的變化, 發(fā)現(xiàn)有修改的代碼會(huì)自動(dòng)編譯打包, 生成輸出文件
配置
package.json的scripts"watch": "webpack --watch"運(yùn)行
npm run watch
以上是cli的方式設(shè)置watch的參數(shù)
還可以通過(guò)配置文件對(duì)watch的參數(shù)進(jìn)行修改:
const path = require('path')
// webpack的配置文件遵循著CommonJS規(guī)范
module.exports = {
entry: './src/main.js',
output: {
// path.resolve() : 解析當(dāng)前相對(duì)路徑的絕對(duì)路徑
// path: path.resolve('./dist/'),
path: path.join(__dirname, './dist/'),
filename: 'bundle.js'
},
mode: 'development',
watch: true
}
運(yùn)行npm run build
webpack-dev-server (推薦)
-
安裝
devServer:devServer需要依賴(lài)webpack,必須在項(xiàng)目依賴(lài)中安裝webpacknpm i webpack-dev-server webpack -D index.html中修改
<script src="/bundle.js"></script>運(yùn)行:
npx webpack-dev-server運(yùn)行:
npx webpack-dev-server --hot --open --port 8090配置
package.json的scripts:"dev": "webpack-dev-server --hot --open --port 8090"運(yùn)行
npm run dev
devServer會(huì)在內(nèi)存中生成一個(gè)打包好的bundle.js,專(zhuān)供開(kāi)發(fā)時(shí)使用,打包效率高,修改代碼后會(huì)自動(dòng)重新打包以及刷新瀏覽器,用戶體驗(yàn)非常好
以上是cli的方式設(shè)置devServer的參數(shù)
還可以通過(guò)配置文件對(duì)devServer的參數(shù)進(jìn)行修改:
- 修改
webpack.config.js
const path = require('path')
module.exports = {
// 入口文件配置
entry: './src/index.js',
// 出口文件配置項(xiàng)
output: {
// 輸出的路徑,webpack2起就規(guī)定必須是絕對(duì)路徑
path: path.join(__dirname, 'dist'),
// 輸出文件名字
filename: 'bundle.js'
},
devServer: {
port: 8090,
open: true,
hot: true
},
mode: 'development'
}
- 修改package.json的scripts:
"dev": "webpack-dev-server" - 運(yùn)行
npm run dev
html插件
- 安裝html-webpack-plugin插件
npm i html-webpack-plugin -D - 在
webpack.config.js中的plugins節(jié)點(diǎn)下配置
const HtmlWebpackPlugin = require('html-webpack-plugin')
plugins: [
new HtmlWebpackPlugin({
filename: 'index.html',
template: 'template.html'//根據(jù)模板生產(chǎn),可以不用
})
]
- devServer時(shí)根據(jù)模板在express項(xiàng)目根目錄下生成html文件(類(lèi)似于devServer生成內(nèi)存中的bundle.js)
- devServer時(shí)自動(dòng)引入bundle.js
- 打包時(shí)會(huì)自動(dòng)生成index.html,或者根據(jù)模板生成html
小結(jié)
只有在開(kāi)發(fā)時(shí)才需要使用自動(dòng)編譯工具, 例如: webpack-dev-server
項(xiàng)目上線時(shí)都會(huì)直接使用webpack進(jìn)行打包構(gòu)建, 不需要使用這些自動(dòng)編譯工具
自動(dòng)編譯工具只是為了提高開(kāi)發(fā)體驗(yàn)
3.webpack的loader處理非js文件
①.webpack處理css文件
- 配置
webpack.config.js
module: {
rules: [
// 配置的是用來(lái)解析.css文件的loader(style-loader和css-loader)
{
// 用正則匹配當(dāng)前訪問(wèn)的文件的后綴名是 .css
test: /\.css$/,
use: ['style-loader', 'css-loader'] // webpack底層調(diào)用這些包的順序是從右到左,從下到上
}
]
}
loader的釋義:
- css-loader: 解析css文件
- style-loader: 將解析出來(lái)的結(jié)果 放到html中, 使其生效
②.webpack處理less文件
- 安裝
npm i less less-loader -D - rules中加入
{ test: /\.less$/, use: ['style-loader', 'css-loader', 'less-loader'] }
③.webpack處理sass文件
- 安裝
npm i sass-loader node-sass -D - rules中加入
{ test: /\.s[ac]ss$/, use: ['style-loader', 'css-loader', 'sass-loader'] }
④.處理圖片文件
- 安裝
npm i file-loader url-loader -D
url-loader封裝了file-loader, 所以使用url-loader時(shí)需要安裝file-loader - 在rules規(guī)則中加入以下規(guī)則:
{
test: /\.(png|jpg|gif)/,
use: [{
loader: 'url-loader',
options: {
// limit表示如果圖片大于5KB,就以路徑形式展示,小于的話就用base64格式展示
limit: 5 * 1024,
// 打包輸出目錄
outputPath: 'images',
// 打包輸出圖片名稱(chēng)
name: '[name]-[hash:4].[ext]'
}
}]
}
⑤.處理字體圖標(biāo)文件
-
npm i bootstarp@3 -S安裝bootstrap3.x 版本的 - 建立index.html給html-webpack-plugin添加一個(gè)模板,指定這個(gè)index.html的文件位置
- 在index.js中引入bootstrap的css樣式文件
import "bootstrap/dist/css/bootstrap.css" - 在index.html中使用bootstrap的字體圖標(biāo),報(bào)錯(cuò)
- 安裝
npm i file-loader url-loader -D - 在rules中加入以下規(guī)則
{test:/\.(woff|woff2|eot|svg|ttf)$/, use:'url-loader'}
4.webpack的babel轉(zhuǎn)換js語(yǔ)法
①.將ES6的語(yǔ)法轉(zhuǎn)為ES5的語(yǔ)法
npm i babel-loader @babel/core @babel/preset-env webpack -D
{
test:/\.js$/,
use:{
loader:"babel-loader",
options:{
presets:["@babel/env"],
}
}
}
②.支持更高級(jí)的ES語(yǔ)法, 需要繼續(xù)安裝插件:
- 比如使用類(lèi)的靜態(tài)屬性:
class Peopel{
//這個(gè)語(yǔ)法babel默認(rèn)不支持,如果需要支持還要下載插件,報(bào)錯(cuò)提示
static name = "李四"
constructor(name,age){
this.age = age
this.name = name
}
}
p = new Peopel("戰(zhàn)三",12)
console.log(p.name)
1.npm i @babel/plugin-proposal-class-properties -D
{
test: /\.js$/,
use: {
loader: 'babel-loader',
options: {
presets: ['@babel/env'],
plugins: ['@babel/plugin-proposal-class-properties']
}
},
exclude: /node_modules/
}
- 使用generator函數(shù)
function *fn(){
yield 1
yield 2
return 3
}
var newFn = fn()
console.log( newFn.next() )
console.log( newFn.next() )
console.log( newFn.next() )
console.log( newFn.next() )
// 打包后運(yùn)行報(bào)錯(cuò),新版本游覽器原本支持使用generator函數(shù),但是使用webpack就會(huì)報(bào)錯(cuò)
regeneratorRuntime is not defined
如果需要使用
generator,無(wú)法直接使用babel進(jìn)行轉(zhuǎn)換,因?yàn)闀?huì)將generator轉(zhuǎn)換為一個(gè)regeneratorRuntime,然后使用mark和wrap來(lái)實(shí)現(xiàn)generator但由于babel并沒(méi)有內(nèi)置regeneratorRuntime,所以無(wú)法直接使用
需要安裝插件:npm i @babel/plugin-transform-runtime -D 同時(shí)還需安裝運(yùn)行時(shí)依賴(lài):npm install --save @babel/runtime 配置文件的時(shí)候不要忘了exclude: /node_modules/,否則報(bào)錯(cuò) babel插件鏈接
"plugins": [
"@babel/plugin-proposal-class-properties",
"@babel/plugin-transform-runtime"
]
官方更建議的做法是在項(xiàng)目根目錄下新建一個(gè).babelrc的babel配置文件,在.babelrc中添加插件,它是json格式的文件:
{
"presets": [
"@babel/env"
],
"plugins": [
"@babel/plugin-proposal-class-properties",
"@babel/plugin-transform-runtime"
]
}
- 使用ES6/7中對(duì)象原型提供的新方法 babel默認(rèn)情況無(wú)法轉(zhuǎn)換,即使用了
transform-runtime的插件也不支持轉(zhuǎn)換原型上的方法
//js是一門(mén)動(dòng)態(tài)語(yǔ)言,在代碼執(zhí)行時(shí)可以隨時(shí)為對(duì)象添加屬性和方法,babel在看到對(duì)象調(diào)用方法的時(shí)候默認(rèn)不會(huì)進(jìn)行轉(zhuǎn)換,include這樣的新方法默認(rèn)不會(huì)轉(zhuǎn)換
var str = "gao"
console.log( str.includes('a') )
需要使用另一個(gè)模塊:npm i @babel/polyfill -S
該模塊需要在使用新方法的地方直接引入:import '@babel/polyfill'
source map的使用
devtool
此選項(xiàng)控制是否生成,以及如何生成 source map。使用source map得啟用瀏覽器的source map設(shè)置
使用 SourceMapDevToolPlugin 進(jìn)行更細(xì)粒度的配置。查看 source-map-loader 來(lái)處理已有的 source map。
選擇一種 source map 格式來(lái)增強(qiáng)調(diào)試過(guò)程。不同的值會(huì)明顯影響到構(gòu)建(build)和重新構(gòu)建(rebuild)的速度。
可以直接使用
SourceMapDevToolPlugin/EvalSourceMapDevToolPlugin來(lái)替代使用devtool選項(xiàng),它有更多的選項(xiàng),但是切勿同時(shí)使用devtool選項(xiàng)和SourceMapDevToolPlugin/EvalSourceMapDevToolPlugin插件。因?yàn)?code>devtool 選項(xiàng)在內(nèi)部添加過(guò)這些插件,所以會(huì)應(yīng)用兩次插件。
| devtool | 構(gòu)建速度 | 重新構(gòu)建速度 | 生產(chǎn)環(huán)境 | 品質(zhì)(quality) |
|---|---|---|---|---|
| (none) | +++ | +++ | yes | 打包后的代碼 |
| eval | +++ | +++ | no | 生成后的代碼 |
| cheap-eval-source-map | + | ++ | no | 轉(zhuǎn)換過(guò)的代碼(僅限行) |
| cheap-module-eval-source-map | o | ++ | no | 原始源代碼(僅限行) |
| eval-source-map | -- | + | no | 原始源代碼 |
| cheap-source-map | + | o | no | 轉(zhuǎn)換過(guò)的代碼(僅限行) |
| cheap-module-source-map | o | - | no | 原始源代碼(僅限行) |
| inline-cheap-source-map | + | o | no | 轉(zhuǎn)換過(guò)的代碼(僅限行) |
| inline-cheap-module-source-map | o | - | no | 原始源代碼(僅限行) |
| source-map | -- | -- | yes | 原始源代碼 |
| inline-source-map | -- | -- | no | 原始源代碼 |
| hidden-source-map | -- | -- | yes | 原始源代碼 |
| nosources-source-map | -- | -- | yes | 無(wú)源代碼內(nèi)容 |
這么多模式用哪個(gè)好?
開(kāi)發(fā)環(huán)境推薦:
? cheap-module-eval-source-map
生產(chǎn)環(huán)境推薦:
? none(不使用source map)
原因如下:
- 使用 cheap 模式可以大幅提高 soure map 生成的效率。大部分情況我們調(diào)試并不關(guān)心列信息,而且就算 source map 沒(méi)有列,有些瀏覽器引擎(例如 v8) 也會(huì)給出列信息。
- 使用 module 可支持 babel 這種預(yù)編譯工具,映射轉(zhuǎn)換前的代碼。
- 使用 eval 方式可大幅提高持續(xù)構(gòu)建效率。官方文檔提供的速度對(duì)比表格可以看到 eval 模式的重新構(gòu)建速度都很快。
- 使用 eval-source-map 模式可以減少網(wǎng)絡(luò)請(qǐng)求。這種模式開(kāi)啟 DataUrl 本身包含完整 sourcemap 信息,并不需要像 sourceURL 那樣,瀏覽器需要發(fā)送一個(gè)完整請(qǐng)求去獲取 sourcemap 文件,這會(huì)略微提高點(diǎn)效率。而生產(chǎn)環(huán)境中則不宜用 eval,這樣會(huì)讓文件變得極大。
這么多模式用哪個(gè)好?
開(kāi)發(fā)環(huán)境推薦:
? cheap-module-eval-source-map
生產(chǎn)環(huán)境推薦:
? none(不使用source map)
原因如下:
- 使用 cheap 模式可以大幅提高 soure map 生成的效率。大部分情況我們調(diào)試并不關(guān)心列信息,而且就算 source map 沒(méi)有列,有些瀏覽器引擎(例如 v8) 也會(huì)給出列信息。
- 使用 module 可支持 babel 這種預(yù)編譯工具,映射轉(zhuǎn)換前的代碼。
- 使用 eval 方式可大幅提高持續(xù)構(gòu)建效率。官方文檔提供的速度對(duì)比表格可以看到 eval 模式的重新構(gòu)建速度都很快。
- 使用 eval-source-map 模式可以減少網(wǎng)絡(luò)請(qǐng)求。這種模式開(kāi)啟 DataUrl 本身包含完整 sourcemap 信息,并不需要像 sourceURL 那樣,瀏覽器需要發(fā)送一個(gè)完整請(qǐng)求去獲取 sourcemap 文件,這會(huì)略微提高點(diǎn)效率。而生產(chǎn)環(huán)境中則不宜用 eval,這樣會(huì)讓文件變得極大。
插件
①.clean-webpack-plugin插件
該插件在npm run build時(shí)自動(dòng)清除dist目錄后重新生成,防止緩存等等
-
安裝插件
npm i clean-webpack-plugin -D -
引入插件
const { CleanWebpackPlugin } = require('clean-webpack-plugin') -
使用插件, 在plugins中直接創(chuàng)建對(duì)象即可
plugins: [ new HtmlWebpackPlugin({ filename: 'index.html', template: './src/index.html' }), new CleanWebpackPlugin() ],
②.copy-webpack-plugin插件
-
安裝插件
npm i copy-webpack-plugin -D -
引入插件
const CopyWebpackPlugin = require('copy-webpack-plugin') 使用插件, 在plugins中插件對(duì)象并配置源和目標(biāo)
-
from: 源, 從哪里拷貝, 可以是相對(duì)路徑或絕對(duì)路徑, 推薦絕對(duì)路徑
to: 目標(biāo), 拷貝到哪里去, 相對(duì)于
output的路徑, 同樣可以相對(duì)路徑或絕對(duì)路徑, 但更推薦相對(duì)路徑(直接算相對(duì)dist目錄即可)plugins: [ new HtmlWebpackPlugin({ filename: 'index.html', template: './src/index.html' }), new CleanWebpackPlugin(), new CopyWebpackPlugin([ { from: path.join(__dirname, 'assets'), to: 'assets' } ]) ],
③.BannerPlugin插件
這是一個(gè)webpack的內(nèi)置插件,用于給打包的JS文件加上版權(quán)注釋信息
-
引入webpack
const webpack = require('webpack') 創(chuàng)建插件對(duì)象
plugins: [
new HtmlWebpackPlugin({
filename: 'index.html',
template: './src/index.html'
}),
new CleanWebpackPlugin(),
new CopyWebpackPlugin([
{
from: path.join(__dirname, 'assets'),
to: 'assets'
}
]),
new webpack.BannerPlugin('GaoChao')
],