webpack4.x版本各種常見配置，快來打造屬於你自己的工作流吧(2018-12-05)

更新日誌

2018-12-05

提高熱更新速度
修改html文件也觸發熱更新

逼逼兩句

關於webpack是什麼，這裏不多說，webpack官方文檔，讓我直接進入正題吧!

1.最基礎的配置

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

npm install webpack webpack-cli --save-dev

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

message.js

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

index.js

import message from './message.js'

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

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>

現在當然沒有boundle.js文件啦，讓我們用webpack將src/index.js打包成boundle.js吧

在根目錄創建webpack入口文件webpack.config.js

webpack.config.js

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

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

package.json

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

現在我們執行npm run build就相當於執行webpack命令了

npm run build

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

2. 打包自動生成html

意思就是，我們執行npm run build之後，可以自動生成index.html、index.js，並且該html裏面自動引入index.js，現在我們可以把根目錄下的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: '我是主頁的標題',
    }),
  ]
}

現在運行

npm run build

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

index.html

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8">
    <title>我是主頁的標題</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函數')

執行打包，打開生成的index.html文件，F12調試

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

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')
  ]
}

執行打包

index.html

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

6. 多頁面入口

以上都是單頁面入口，只允許配置一個html文件以及對應的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: '我是主頁的標題',
      chunks: ['index']
    }),
    new HtmlWebpackPlugin({
      filename: 'about.html',
      title: '我是關於我們頁面的標題',
      chunks: ['about']
    }),
  ]
}

執行打包

7. 多頁面分離css

只需要把css名字動態化即可

index.js

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

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

about.js

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

message('大家好，我是關於我們')

配置

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文件名字動態化
  ]
}

打包後，看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最新標準的代碼轉爲es5代碼，首先需要安裝babel-core、babel-loader（7.1.5版本）、以及轉換版本babel-preset-env

npm install [email protected] 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}`)

執行打包

10. API轉換

babel默認只轉換JavaScript語法，對於新的API，比如Iterator、Generator、Set、Maps、Proxy、Reflect、Symbol、Promise等是不會轉換的。如果需要轉換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的背景圖設置等），需要安裝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]'
      }
    }]
  }
}

執行打包

12. 清除dist文件夾

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

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

配置

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

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

13. 分文件夾管理

現在打包之後dist文件夾，太亂了，我們需要在裏面用css、js、images文件夾進行分類管理

配置

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

module.exports = {
  output: {
    filename: 'js/[name].js', // 在文件名前面加上目錄名稱即可實現
  },
  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文件生成的目錄
}

執行打包

舒服多了

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

大家應該發現了，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. 開啓本地服務器，並且設置熱更新

熱更新是webpack的一個特性，通過無刷新實現代碼更新

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

package.json

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

配置

let webpack = require('webpack')

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

啓動服務（是不是感覺像極了vue-cli項目）

npm run dev

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

默認訪問index.html

輸入http://localhost:3000/about.html訪問關於我們

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

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

npm install raw-loader --save

新增配置

let webpack = require('webpack')

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

在入口文件導入模板文件

import '../index.html'

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

本文到此結束了，如有錯誤，請大家指出來，至於哪個模塊不懂的可以去https://www.npmjs.com搜索相應的包名查看文檔，喜歡的給個推薦 / 收藏哦

歡迎所有前端愛好者關注我的個人微信公衆號，我會經常分享最新，實用性高的前端文章以及技巧，祝你在前端開發的道路上刀過竹解！

webpack4.x版本各種常見配置，快來打造屬於你自己的工作流吧(2018-12-05)

更新日誌

逼逼兩句

PDManer [元數建模]-v4.9.0 發佈：一款簡單好用的數據庫建模平臺

使用neovim打造go ide(支持代碼跳轉, 代碼補全, 實時語法檢查)

sql求連續值問題

cs01 CSS Syntax

挑戰程序設計競賽 2.3章習題 poj 3046 Ant Counting

[MASM拾遺]Offset僞指令

h30 HTML Layout Elements

瞭解顯卡

一款基於C#開發的通訊調試工具（支持Modbus RTU、MQTT調試）

Linux/Golang/glibC系統調用

你可能不知道的css騷操作 — 表單驗證🤦‍♂️

你可能不知道的css騷操作 — tab切換😁

Nuxt開發經驗分享，讓你踩少點坑！

帶你入門優雅的Mo.js（圖形動畫Javascript庫）

html指令式tooltip文字提示，css實現，無腳本

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結