webpack4.x版本各種常見配置，快來打造屬于你自己的工作流吧

更新日志

2018-12-05

  1. 提高熱更新速度
  2. 修改html文件也觸發(fā)熱更新
逼逼兩句

關(guān)于webpack是什么，這里不多說，webpack官方文檔，讓我直接進入正題吧!

1.最基礎(chǔ)的配置

新建一個文件夾，就叫webpack吧，先安裝主要依賴

npm install webpack webpack-cli --save-dev

讓我們試試打包一個javascript文件看看，在src目錄下創(chuàng)建index.js、message.js文件，在根目錄創(chuàng)建index.html文件

message.js

export default function (message) {
  console.log(message)
}

index.js

import message from './message.js'

message('大家好，我是message函數(shù)')

index.html

<!DOCTYPE html>
<html lang="en">

<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no">
  <meta http-equiv="X-UA-Compatible" content="ie=edge">
  <title>我的第一個webpack程序</title>
</head>

<body>

  <script src="boundle.js"></script>

</body>

</html>

現(xiàn)在當(dāng)然沒有boundle.js文件啦，讓我們用webpack將src/index.js打包成boundle.js吧

在根目錄創(chuàng)建webpack入口文件webpack.config.js

webpack.config.js

module.exports = {
  // 入口
  entry: './src/index.js',
  
  // 輸出
  output: {
    filename: 'boundle.js', // 文件名
    path: __dirname // 輸出路徑
  }
}

怎么運行呢？如果webpack、webpack-cli安裝到了全局環(huán)境，那么直接在命令行直接輸入webpack就可以進行打包了，現(xiàn)在我們webpack、webpack-cli是安裝到了項目依賴中，所以得稍微配置一下

package.json

{
  "devDependencies": {
    "webpack": "^4.20.2",
    "webpack-cli": "^3.1.2",
  },
  "scripts": {
    "build": "webpack"
  }
}

現(xiàn)在我們執(zhí)行npm run build就相當(dāng)于執(zhí)行webpack命令了

npm run build

現(xiàn)在你可以看到，根目錄下生成了個boundle.js文件，現(xiàn)在打開index.html，看控制臺輸出"大家好，我是message函數(shù)"

2. 打包自動生成html

意思就是，我們執(zhí)行npm run build之后，可以自動生成index.html、index.js，并且該html里面自動引入index.js，現(xiàn)在我們可以把根目錄下的index.html刪掉了，以后用不上

安裝依賴，html-webpack-plugin

npm install html-webpack-plugin --save-dev

webpack.config.js

let HtmlWebpackPlugin = require('html-webpack-plugin')

module.exports = {
  entry: './src/index.js',
  output: {
    filename: 'index.js', // 輸出之后的js文件名
    path: __dirname + '/dist' // 輸出路徑，一般我們輸出到dist文件夾
  },
  // 使用插件
  plugins: [
    // 生成html
    new HtmlWebpackPlugin({
      filename: 'index.html',
      title: '我是主頁的標(biāo)題',
    }),
  ]
}

現(xiàn)在運行

npm run build

可以看到在根目錄下生成了dist文件夾

index.html

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8">
    <title>我是主頁的標(biāo)題</title>
  </head>
  <body>
  <script type="text/javascript" src="index.js"></script></body>
</html>

3. 模板文件

新建template.html

<!DOCTYPE html>
<html lang="en">

<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <meta http-equiv="X-UA-Compatible" content="ie=edge">
  <title>我是模板文件</title>
</head>

<body></body>

</html>

配置

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

4. 使用css

可以使javascript腳本中引入css文件，并且寫入到html

npm install style-loader css-loader --save-dev

配置

module.exports = {
  module: {
    rules: [{
      test: /\.css$/, // 匹配.css文件
      use: ['style-loader', 'css-loader'] // 使用插件
    }]
  },
}

// index.js
import message from './message.js'
import './index.css'

message('大家好，我是message函數(shù)')

執(zhí)行打包，打開生成的index.html文件，F(xiàn)12調(diào)試


可以看到自己寫的css文件被javascript寫入到head中，那如果你想像javascript文件一樣外聯(lián)的形式引入，該怎么做呢？

5. 分離css

npm install extract-text-webpack-plugin@next --save-dev

配置

let ExtractTextWebpackPlugin = require('extract-text-webpack-plugin')

module.exports = {
  module: {
   rules: [{
      test: /\.css$/,
      use: ExtractTextWebpackPlugin.extract({
        fallback: 'style-loader',
        use: 'css-loader'
      })
    }]
  },
  plugins: [
    new ExtractTextWebpackPlugin('index.css')
  ]
}

執(zhí)行打包


index.html

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8">
    <title>我是主頁的標(biāo)題</title>
  <link href="index.css" rel="stylesheet"></head>
  <body>
  <script type="text/javascript" src="index.js"></script></body>
</html>

6. 多頁面入口

以上都是單頁面入口，只允許配置一個html文件以及對應(yīng)的javascript、css，那么如何配置多個頁面呢？

配置

let HtmlWebpackPlugin = require('html-webpack-plugin')

module.exports = {
  entry: {
    index: './src/index.js',
    about: './src/about.js'
  },
  output: {
    filename: '[name].js?[hash]', // 生成的名字由entry中的屬性決定，并且加上了版本號
    path: __dirname + '/dist'
  },
  plugins: [
    new HtmlWebpackPlugin({
      filename: 'index.html',
      title: '我是主頁的標(biāo)題',
      chunks: ['index']
    }),
    new HtmlWebpackPlugin({
      filename: 'about.html',
      title: '我是關(guān)于我們頁面的標(biāo)題',
      chunks: ['about']
    }),
  ]
}

執(zhí)行打包


7. 多頁面分離css

只需要把css名字動態(tài)化即可

index.js

import message from './message.js'
import './index.css'

message('大家好，我是主頁')

about.js

import message from './message.js'
import './about.css'

message('大家好，我是關(guān)于我們')

配置

let ExtractTextWebpackPlugin = require('extract-text-webpack-plugin')

module.exports = {
  module: {
    rules: [{
      test: /\.css$/,
      use: ExtractTextWebpackPlugin.extract({
        fallback: 'style-loader',
        use: 'css-loader'
      })
    }]
  },
  plugins: [
    new ExtractTextWebpackPlugin('[name].css'), // css文件名字動態(tài)化
  ]
}

打包后，看dist文件夾目錄


8. css瀏覽器自動補全前綴

npm install postcss-loader autoprefixer --save-dev

在根目錄新建postcss.config.js文件

module.exports = {
  plugins: [require('autoprefixer')]
}

配置（css不分離寫法）

module.exports = {
  module: {
    rules: [{
      test: /\.css$/,
      use: ['style-loader', 'css-loader', 'postcss-loader']
    }]
  }
}

配置（css分離寫法）

module.exports = {
  module: {
    rules: [{
      test: /\.css$/,
      use: ExtractTextWebpackPlugin.extract({
        fallback: 'style-loader',
        use: ['css-loader', 'postcss-loader']
      })
    }]
  }
}

9. babel

babel可以把es最新標(biāo)準的代碼轉(zhuǎn)為es5代碼，首先需要安裝babel-core、babel-loader（7.1.5版本）、以及轉(zhuǎn)換版本babel-preset-env

npm install babel-loader@7.1.5 babel-core babel-preset-env --save-dev

配置

module.exports = {
  module: {
    rules: [{
      test: /\.js$/,
      exclude: /node_modules/,
      use: {
        loader: 'babel-loader',
        options: {
          presets: ['env'],
          cacheDirectory: true
        }
      }
    }]
  }
}

寫一段ES6代碼測試一下

import message from './message.js'
import './index.css'

let name = '主頁'

message(`大家好，我是${name}`)

執(zhí)行打包


10. API轉(zhuǎn)換

babel默認只轉(zhuǎn)換JavaScript語法，對于新的API，比如Iterator、Generator、Set、Maps、Proxy、Reflect、Symbol、Promise等是不會轉(zhuǎn)換的。如果需要轉(zhuǎn)換API，需要使用babel-polyfill

安裝依賴

npm install babel-polyfill --save-dev

在你的javascript文件頂部引入

import 'babel-polyfill';
let set = new Set([1,2,3]);

11. 圖片資源

webpack處理圖片、字體、音樂、視頻等資源時（javascript中require，css的背景圖設(shè)置等），需要安裝file-loader

cnpm install file-loader --save-dev

配置

module.exports = {
  module: {
    rules: [{
      test: /\.(png|jpe?g|gif|svg)(\?\S*)?$/,
      loader: 'file-loader',
      query: {
        name: '[name].[ext]?[hash]'
      }
    }]
  }
}

執(zhí)行打包


12. 清除dist文件夾

每次打包前都能自動清除dist文件夾下的文件

npm install clean-webpack-plugin --save-dev

配置

let CleanWebpackPlugin = require('clean-webpack-plugin')

module.exports = {
  plugins: [
    new CleanWebpackPlugin(['dist'])
  ]
}

13. 分文件夾管理

現(xiàn)在打包之后dist文件夾，太亂了，我們需要在里面用css、js、images文件夾進行分類管理


配置

let ExtractTextWebpackPlugin = require('extract-text-webpack-plugin')

module.exports = {
  output: {
    filename: 'js/[name].js', // 在文件名前面加上目錄名稱即可實現(xiàn)
  },
  module: {
    rules: [{
      test: /\.(png|jpe?g|gif|svg)(\?\S*)?$/,
      loader: 'file-loader',
      query: {
        name: '[name].[ext]?[hash]',
        outputPath: 'images' // 配置圖片生成的目錄
      }
    }]
  },
  plugins: [
    new ExtractTextWebpackPlugin('css/[name].css') // 配置css文件生成的目錄
}

執(zhí)行打包


舒服多了

14. 壓縮分離出來的css文件

大家應(yīng)該發(fā)現(xiàn)了，javascript文件自動壓縮了，無需配置，但是分離出來的css文件沒有自動壓縮

npm install optimize-css-assets-webpack-plugin --save-dev

配置

let OptimizeCssAssetsPlugin = require('optimize-css-assets-webpack-plugin')

module.exports = {
  plugins: [
    new OptimizeCssAssetsPlugin()
  ]
}

15. 開啟本地服務(wù)器，并且設(shè)置熱更新

熱更新是webpack的一個特性，通過無刷新實現(xiàn)代碼更新

npm install webpack-dev-server --save-dev

package.json

{
  "scripts": {
    "dev": "webpack-dev-server"
  }
}

配置

let webpack = require('webpack')

module.exports = {
  mode: 'development', // 開發(fā)模式，熱更新速度提高
  plugins: [
    new webpack.HotModuleReplacementPlugin() // 啟用HMR
  ],
  devServer: {
    contentBase: __dirname + '/dist', // 默認目錄
    port: 3000, // 端口
    open: true, // 運行時自動在瀏覽器打開
    hot: true // 開啟熱更新
  }
}

啟動服務(wù)（是不是感覺像極了vue-cli項目）

npm run dev

然后瀏覽器會自動打開http://localhost:3000

默認訪問index.html

輸入http://localhost:3000/about.html訪問關(guān)于我們

注意，現(xiàn)在修改javascript，css代碼才能觸發(fā)熱更新（css不分離模式才觸發(fā)），html模板文件則不能

16. 讓修改html模板文件也觸發(fā)熱更新（必須要有模板文件）

npm install raw-loader --save

新增配置

let webpack = require('webpack')

module.exports = {
 module: {
    rules: [{
      test: /\.(htm|html)$/,
      use: [
        'raw-loader'
      ]
    }]
  },
}

在入口文件導(dǎo)入模板文件

import '../index.html'

點擊下載模板(暫無添加修改html文件的代碼，自己看著第16步自行添加喔)

最后

本文到此結(jié)束，希望以上內(nèi)容對你有些許幫助，如若喜歡請記得點個贊跟關(guān)注哦 ??

image

微信公眾號「前端宇宙情報局」，將不定時更新最新、實用的前端技巧/技術(shù)性文章，歡迎關(guān)注，一起學(xué)習(xí) ??

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

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

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