Webpack配置Vue項目

 

一. 基本配置

1.  在項目中安裝和配置 webpack

使用webpack打包生成的文件就不會存在兼容性問題，可以使用es6的import語法

① 運行 npm install webpack webpack-cli –D 命令，安裝 webpack 相關的包

② 在項目根目錄中，創建名為 webpack.config.js 的 webpack 配置文件

③ 在 webpack 的配置文件中，初始化如下基本配置：

 注：使用development開發模式打包不會混淆和壓縮，編譯快速

　　 使用生產模式會壓縮和混淆代碼，編譯速度慢

module.exports = {  
 mode: 'development' // mode 用來指定構建模式
}

④ 在 package.json 配置文件中的 scripts 節點下，新增 dev 腳本如下： 

"scripts": { 
 "dev": "webpack" // script 節點下的腳本，可以通過 npm run 執行 
}

⑤ 在終端中運行 npm run dev 命令，啟動 webpack 進行項目打包。

 

2. 配置打包的入口與出口

webpack 的 4.x 版本中默認約定： 

　　打包的入口文件為 src -> index.js 

　　打包的輸出文件為 dist -> main.js

如果要修改打包的入口與出口，可以在 webpack.config.js 中新增如下配置信息： 

const path = require('path') // 導入 node.js 中專門操作路徑的模塊 
module.exports = {   
　　entry: path.join(__dirname, './src/index.js'), // 打包入口文件的路徑  
　　output: {  
   　　path: path.join(__dirname, './dist'), // 輸出文件的存放路徑  
   　　filename: 'bundle.js' // 輸出文件的名稱   } 
} 

 

 

3. 配置 html-webpack-plugin 生成預覽頁面（拷貝html文件到編譯目錄下）

① 運行 npm install html-webpack-plugin –D 命令，安裝生成預覽頁面的插件

② 修改 webpack.config.js 文件頭部區域，添加如下配置信息： 

// 導入生成預覽頁面的插件，得到一個構造函數 
const HtmlWebpackPlugin = require('html-webpack-plugin') 

const htmlPlugin = new HtmlWebpackPlugin({ // 創建插件的實例對象
   template: './src/index.html', // 指定要用到的模板文件
   filename: 'index.html' // 指定生成的文件的名稱，該文件存在於內存中，在目錄中不顯示
 }) 

③ 修改 webpack.config.js 文件中向外暴露的配置對象，新增如下配置節點：

module.exports = {
   plugins: [ htmlPlugin ] // plugins 數組是 webpack 打包期間會用到的一些插件列表
 } 

 

 

4. 配置 webpack 的自動打包功能：客戶端開啟http服務會根據代碼改變自動打包刷新網頁

① 運行 npm install webpack-dev-server –D 命令，安裝支持項目自動打包的工具

② 修改 package.json -> scripts 中的 dev 命令如下：

"scripts": {
 "dev": "webpack-dev-server" // script 節點下的腳本，可以通過 npm run 執行 
} 

③ 將 src -> index.html 中，script 腳本的引用路徑，修改為 "/buldle.js“

④ 運行 npm run dev 命令，重新進行打包

⑤ 在瀏覽器中訪問 http://localhost:8080 地址，查看自動打包效果
注意：

 webpack-dev-server 會啟動一個實時打包的 http 服務器

 webpack-dev-server 打包生成的輸出文件，默認放到了項目根目錄中，而且是虛擬的、看不見的

 

 

5.  配置自動打包相關的參數 （自動打開瀏覽器）

 // package.json中的配置  
 // --open 打包完成后自動打開瀏覽器頁面  
 // --host 配置 IP 地址 
 // --port 配置端口 
  "scripts": { 
    "dev": "webpack-dev-server --open --host 127.0.0.1 --port 8888" 
  }, 

 

 

二. webpack 中的加載器 

1. 通過 loader 打包非 js 模塊

　　在實際開發過程中，webpack 默認只能打包處理以 .js 后綴名結尾的模塊，其他非 .js 后綴名結 尾的模塊，webpack 默認處理不了，需要調用 loader 加載器才可以正常打包，否則會報錯！

　　loader 加載器可以協助 webpack 打包處理特定的文件模塊，比如：

　　 less-loader 可以打包處理 .less 相關的文件

　　 sass-loader 可以打包處理 .scss 相關的文件

　　 url-loader 可以打包處理 css 中與 url 路徑相關的文件

 

 

2. loader 的調用過程

 

 

 

 

三. webpack 中加載器的基本使用 

1. 打包處理 css 文件

經過css-loader處理后，可以在JavaScript模塊中直接使用import語句導入css模塊。但是使用css-loader的前提是先使用npm安裝css-loader

① 運行 npm i style-loader css-loader -D 命令，安裝處理 css 文件的 loader

② 在 webpack.config.js 的 module -> rules 數組中，添加 loader 規則如下：

// 所有第三方文件模塊的匹配規則 module: { 
rules: [ 
{ test: /\.css$/, use: ['style-loader', 'css-loader'] } 
] 
} 

其中，test 表示匹配的文件類型， use 表示對應要調用的 loader

注意：

 use 數組中指定的 loader 順序是固定的

 多個 loader 的調用順序是：從后往前調用

 

 

2. 打包處理 less 文件

① 運行 npm i less-loader less -D 命令

② 在 webpack.config.js 的 module -> rules 數組中，添加 loader 規則如下：

// 所有第三方文件模塊的匹配規則   module: { 
    rules: [ 
      { test: /\.less$/, use: ['style-loader', 'css-loader', 'less-loader'] } 
    ] 
  } 

 

 

3. 打包處理 scss 文件

① 運行 npm i sass-loader node-sass -D 命令

② 在 webpack.config.js 的 module -> rules 數組中，添加 loader 規則如下：

  // 所有第三方文件模塊的匹配規則   module: { 
    rules: [ 
      { test: /\.scss$/, use: ['style-loader', 'css-loader', 'sass-loader'] } 
    ] 
  }

　

　

4. 配置 postCSS 自動添加 css 的兼容前綴（自動添加瀏覽器css兼容前綴）

① 運行 npm i postcss-loader autoprefixer -D 命令

② 在項目根目錄中創建 postcss 的配置文件 postcss.config.js，並初始化如下配置：

 const autoprefixer = require('autoprefixer') // 導入自動添加前綴的插件
   module.exports = {
     plugins: [ autoprefixer ] // 掛載插件   
}

③ 在 webpack.config.js 的 module -> rules 數組中，修改 css 的 loader 規則如下：

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

 

 

5. 打包樣式表中的圖片和字體文件（能夠在css中使用url訪問圖片）

① 運行 npm i url-loader file-loader -D 命令

② 在 webpack.config.js 的 module -> rules 數組中，添加 loader 規則如下：

module: { 
　　rules: [ 
　　　　{ 
　　　　　　test: /\.jpg|png|gif|bmp|ttf|eot|svg|woff|woff2$/, 
　　　　　　use: 'url-loader?limit=16940' 
　　　　} 
　　] 
} 

其中 ? 之后的是 loader 的參數項。

limit 用來指定圖片的大小，單位是字節(byte),只有小於 limit 大小的圖片，才會被轉為 base64 圖片

 

 

6. 打包處理 js 文件中的高級語法（能夠處理使用class導出語法）

① 安裝babel轉換器相關的包：npm i babel-loader @babel/core @babel/runtime -D

② 安裝babel語法插件相關的包：npm i @babel/preset-env @babel/plugin-transformruntime @babel/plugin-proposal-class-properties –D

③ 在項目根目錄中，創建 babel 配置文件 babel.config.js 並初始化基本配置如下：

  module.exports = { 
    presets: [ '@babel/preset-env' ], 
    plugins: [ '@babel/plugin-transform-runtime', '@babel/plugin-proposal-class-properties’ ] 
  }

④ 在 webpack.config.js 的 module -> rules 數組中，添加 loader 規則如下：

 // exclude 為排除項，表示 babel-loader 不需要處理 node_modules 中的 js 文件
   { test: /\.js$/, use: 'babel-loader', exclude: /node_modules/ } 

 

 

四. Vue 單文件組件

1. Vue 單文件組件的基本用法 

單文件組件的組成結構
 template 組件的模板區域

 script 業務邏輯區域

 style 樣式區域：使用scoped表示限制作用域此樣式僅僅此組件使用，不影響其他樣式

<template> 
    <!-- 這里用於定義Vue組件的模板內容 -->
</template> 
 
<script> 
    // 這里用於定義Vue組件的業務邏輯
     export default {
       data: () { return {} }, // 私有數據
       methods: {} // 處理函數
       // ... 其它業務邏輯
     } 
 </script> 
 
<style scoped> 
    /* 這里用於定義組件的樣式 */   
</style> 

 

 

2.  webpack 中配置 vue 組件的加載器 

① 運行 npm i vue-loader vue-template-compiler -D 命令

② 在 webpack.config.js 配置文件中，添加 vue-loader 的配置項如下

const VueLoaderPlugin = require('vue-loader/lib/plugin') 
module.exports = { 
  module: { 
    rules: [       // ... 其它規則       { test: /\.vue$/, loader: 'vue-loader' } 
    ] 
  }, 
  plugins: [     // ... 其它插件     new VueLoaderPlugin() // 請確保引入這個插件！   ] 
} 

 

 

3. 在 webpack 項目中使用 vue 

① 運行 npm i vue –S 安裝 vue

② 在 src -> index.js 入口文件中，通過 import Vue from 'vue' 來導入 vue 構造函數

③ 創建 vue 的實例對象，並指定要控制的 el 區域

④ 通過 render 函數渲染 App 根組件

// 1. 導入 Vue 構造函數 import Vue from 'vue' 
// 2. 導入 App 根組件 import App from './components/App.vue' 
 
const vm = new Vue({
   // 3. 指定 vm 實例要控制的頁面區域   el: '#app',
   // 4. 通過 render 函數，把指定的組件渲染到 el 區域中
   render: h => h(App) 
})