Webpack基礎(chǔ)

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)的其他事

  1. 配置webpack.config.js

  2. 運(yùn)行npx webpack會(huì)自動(dòng)加載當(dāng)前目錄內(nèi)的webpack.config.js文件,或者可以在package.json文件的script腳本內(nèi)配置"build":"webpack":然后使用npm run build即可打包

    1. 按照指定文件打包的話需要配置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)編譯代碼:

  1. webpack's Watch Mode

  2. webpack-dev-server

  3. webpack-dev-middleware

watch

webpack指令后面加上--watch參數(shù)即可

主要的作用就是監(jiān)視本地項(xiàng)目文件的變化, 發(fā)現(xiàn)有修改的代碼會(huì)自動(dòng)編譯打包, 生成輸出文件

  1. 配置package.json的scripts"watch": "webpack --watch"

  2. 運(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 (推薦)

  1. 安裝devServer

    devServer需要依賴(lài)webpack,必須在項(xiàng)目依賴(lài)中安裝webpack

    npm i webpack-dev-server webpack -D

  2. index.html中修改 <script src="/bundle.js"></script>

  3. 運(yùn)行:npx webpack-dev-server

  4. 運(yùn)行:npx webpack-dev-server --hot --open --port 8090

  5. 配置package.json的scripts:"dev": "webpack-dev-server --hot --open --port 8090"

  6. 運(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)行修改:

  1. 修改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'
}
  1. 修改package.json的scripts: "dev": "webpack-dev-server"
  2. 運(yùn)行npm run dev

html插件

  1. 安裝html-webpack-plugin插件npm i html-webpack-plugin -D
  2. 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),可以不用
    })
]
  1. devServer時(shí)根據(jù)模板在express項(xiàng)目根目錄下生成html文件(類(lèi)似于devServer生成內(nèi)存中的bundle.js)
  2. devServer時(shí)自動(dòng)引入bundle.js
  3. 打包時(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文件

  1. 配置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的釋義:

  1. css-loader: 解析css文件
  2. style-loader: 將解析出來(lái)的結(jié)果 放到html中, 使其生效

②.webpack處理less文件

  1. 安裝npm i less less-loader -D
  2. rules中加入{ test: /\.less$/, use: ['style-loader', 'css-loader', 'less-loader'] }

③.webpack處理sass文件

  1. 安裝npm i sass-loader node-sass -D
  2. rules中加入{ test: /\.s[ac]ss$/, use: ['style-loader', 'css-loader', 'sass-loader'] }

④.處理圖片文件

  1. 安裝npm i file-loader url-loader -D
    url-loader封裝了file-loader, 所以使用url-loader時(shí)需要安裝file-loader
  2. 在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)文件

  1. npm i bootstarp@3 -S安裝bootstrap3.x 版本的
  2. 建立index.html給html-webpack-plugin添加一個(gè)模板,指定這個(gè)index.html的文件位置
  3. 在index.js中引入bootstrap的css樣式文件import "bootstrap/dist/css/bootstrap.css"
  4. 在index.html中使用bootstrap的字體圖標(biāo),報(bào)錯(cuò)
  5. 安裝npm i file-loader url-loader -D
  6. 在rules中加入以下規(guī)則 {test:/\.(woff|woff2|eot|svg|ttf)$/, use:'url-loader'}

4.webpack的babel轉(zhuǎn)換js語(yǔ)法

①.將ES6的語(yǔ)法轉(zhuǎn)為ES5的語(yǔ)法

  1. 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,然后使用markwrap來(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)

原因如下:

  1. 使用 cheap 模式可以大幅提高 soure map 生成的效率。大部分情況我們調(diào)試并不關(guān)心列信息,而且就算 source map 沒(méi)有列,有些瀏覽器引擎(例如 v8) 也會(huì)給出列信息。
  2. 使用 module 可支持 babel 這種預(yù)編譯工具,映射轉(zhuǎn)換前的代碼。
  3. 使用 eval 方式可大幅提高持續(xù)構(gòu)建效率。官方文檔提供的速度對(duì)比表格可以看到 eval 模式的重新構(gòu)建速度都很快。
  4. 使用 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)

原因如下:

  1. 使用 cheap 模式可以大幅提高 soure map 生成的效率。大部分情況我們調(diào)試并不關(guān)心列信息,而且就算 source map 沒(méi)有列,有些瀏覽器引擎(例如 v8) 也會(huì)給出列信息。
  2. 使用 module 可支持 babel 這種預(yù)編譯工具,映射轉(zhuǎn)換前的代碼。
  3. 使用 eval 方式可大幅提高持續(xù)構(gòu)建效率。官方文檔提供的速度對(duì)比表格可以看到 eval 模式的重新構(gòu)建速度都很快。
  4. 使用 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目錄后重新生成,防止緩存等等

  1. 安裝插件

    npm i clean-webpack-plugin -D

  2. 引入插件

    const { CleanWebpackPlugin } = require('clean-webpack-plugin')
    
  3. 使用插件, 在plugins中直接創(chuàng)建對(duì)象即可

    plugins: [
        new HtmlWebpackPlugin({
          filename: 'index.html',
          template: './src/index.html'
        }),
        new CleanWebpackPlugin()
      ],
    

②.copy-webpack-plugin插件

  1. 安裝插件

    npm i copy-webpack-plugin -D

  2. 引入插件

    const CopyWebpackPlugin = require('copy-webpack-plugin')
    
  3. 使用插件, 在plugins中插件對(duì)象并配置源和目標(biāo)

  4. 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)注釋信息

  1. 引入webpack

    const webpack = require('webpack')
    
  2. 創(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')
],
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • 模塊化 CommonJS CommonJS是一種使用廣泛的 JavaScript模塊化規(guī)范,核心思想是通過(guò) req...
    小小的白菜閱讀 641評(píng)論 0 12
  • 深入淺出Webpack學(xué)習(xí)筆記 基本概念 常用的構(gòu)建工具 所有的構(gòu)建工具所做的工做大致一樣,都是把源代碼翻譯轉(zhuǎn)換成...
    IsaacHHH閱讀 553評(píng)論 0 0
  • 入門(mén)介紹 為什么選擇webpack 大多數(shù)團(tuán)隊(duì)在開(kāi)發(fā)新項(xiàng)目時(shí)會(huì)采用緊跟時(shí)代的技術(shù),這些技術(shù)幾乎都會(huì)采用“ 模塊化+...
    一米陽(yáng)光kk閱讀 2,422評(píng)論 0 9
  • 引言 該SeekBar由自定義view來(lái)實(shí)現(xiàn),主要完成了普通的進(jìn)度條(可修改進(jìn)度條的顏色,游標(biāo)顏色,二級(jí)進(jìn)度條顏色...
    只有一條尾巴的貓閱讀 1,607評(píng)論 0 2
  • 過(guò)完吃了可以睡,睡醒了可以玩的開(kāi)心年。又得背上行李,拉著皮箱,去外地工作。其實(shí)我真不喜歡那個(gè)狀態(tài),早上很早就去上班...
    無(wú)衣師尹_a5c9閱讀 174評(píng)論 0 0

友情鏈接更多精彩內(nèi)容