手把手教你使用webpack實作vue-cli-Vue.js-PHP中文網

手把手教你使用webpack實作vue-cli

當我們剛開始學習vue的時候我們都是使用vue-cli來建立一個基礎的vue專案的基礎目錄結構，並且實作使用npm run serve，啟動我們的vue專案並在本地運行一個8080端口的服務，並且當我們修改並保存時，本地的端口頁面也會隨之刷新，類似於live-server的功能。【相關推薦：vuejs影片教學】

前言

要想實作一個vue-cli的鷹架，我們先要了解什麼是webpack？如何使用webpack？

手把手教你使用webpack實作vue-cli

本質上，webpack 是一個現代 JavaScript 應用程式的靜態模組打包器(module bundler) 。當webpack 處理應用程式時，它會遞歸地建立一個依賴關係圖(dependency graph) ，其中包含應用程式所需的每個模組，然後將所有這些模組打包成一個或多個 bundle。其中包括四個核心概念：

入口(entry)
輸出(output)
loader
外掛程式(plugins)

接下來，我們一邊來實作vue-cli給我們的基礎架構，一邊來簡單說一說webpack的核心概念。

vue-cli實現過程

首先我們打開一個資料夾，在當前資料夾下打開終端，首先在終端運行npm init -y,使得當前文件下具備package.json的文件，這樣我們的這個專案就可以從(node庫(npmjs.com))裡去安裝我們所需要的依賴,首先我們去使用終端安裝webpack 和webpack-cli ，在終端機中執行npm install webpack webpack-cli(或npm i webpack webpack-cli)

##首先我們在專案的根目錄下，建立一個

index.html，只在其中放一個id為app的容器

nbsp;html>

登入後複製

在根目錄下建立一個

src資料夾，裡面建立一個main .js，通常情況下我們在vue專案裡都是用.vue後綴的檔案來寫元件或是頁面（通常我們所謂的頁面，實際上只是藉助路由跳轉，不算真正意義的頁面，通常我們會稱之為頁面）,因為我們沒有使用vue-cli搭建項目，所以並沒有把vue的源碼和webpack結合，所以我們要手動引入vue的源碼，使得我們可以使用vue的語法,那麼我們應該先使用node安裝一個vue的源碼在終端機中運行npm i vue，因為最新的我們是引入了vue3的源碼，所以不再是將整個vue實例物件引入到專案中，因為在vue3中為了提高效能，所有的程式碼都是按需引入的，而不是像vue2一樣將整個vue的實例物件引入到專案中，直接去使用實例物件上的方法。

如果我們不在專案裡引入vue的源碼，那我們在main.js中只能寫原生js的語法，如下：

未引入vue源码的main.js:

function comp() {
  const el = document.createElement("div");

  el.innerHTML = '你好,vue-cli'

  return el
}

document.body.appendChild(comp())

登入後複製

手把手教你使用webpack實作vue-cli

那如果我們再給他加點樣式，該怎麼辦呢？理論上webpack只能打包js文件，那css、less、以及vue後綴的文件它是怎麼處理的呢？我們一步一步來看，既然是vue項目，我們通常都是寫vue後綴的文件，有時候寫項目為了方便同樣也會在src文件下建一個style的文件夾，裡面處理一些項目裡的公共樣式，但在此處，我們就不再嵌套資料夾，其實原理都是一樣的，如果嵌套資料夾，只需要將檔案的路徑更改一下就能實現。

main.js

import { createApp } from 'vue';
import './style.css'
import App from './App.vue'

const app = createApp(App)
app.mount('#app')

登入後複製

在src目錄下，我們新建一個

style.css檔案和一個App.vue,其程式碼如下：

style.css:

div{
  color: red;
}

登入後複製

App.vue:

登入後複製

專案其中基本的檔案類型就是這些，如果你需要使用到

.less的檔案或.stylus檔案等，那麼我們在webpack的四大核心之一的loader中去設定一些規則，使得將.less的檔案或.stylus檔案先轉化為.css文件，再告訴webpack去載入CSS檔案。

既然要使用webpack的核心功能那麼首先我們應該在根目錄下創建一個webpack的設定檔

webpack.config.js接下來我帶著大家一起來一個核心部分來了解。

入口(entry)

入口起点(entry point) 指示 webpack 应该使用哪个模块，来作为构建其内部依赖图的开始。进入入口起点后，webpack 会找出有哪些模块和库是入口起点（直接和间接）依赖的。可以通过在 webpack 配置中配置 entry 属性，来指定一个入口起点（或多个入口起点）。默认值为 ./src。

module.exports = {
  entry: './src/main.js', // 项目入口文件（打包这个文件）
};

登入後複製

根据应用程序的特定需求，可以以多种方式配置 entry 属性。从入口起点章节可以了解更多信息。

出口(output)

output 属性告诉 webpack 在哪里输出它所创建的 bundles，以及如何命名这些文件，默认值为 ./dist。基本上，整个应用程序结构，都会被编译到你指定的输出路径的文件夹中。你可以通过在配置中指定一个 output 字段，来配置这些处理过程：

const path = require('path'); // node 提供的方法获取绝对路径

module.exports = {
  entry: './src/main.js', // 项目入口文件（打包这个文件） 
  output: { 
      path: path.resolve(__dirname,'dist'), // webpack要求必须要绝对路径,__dirname项目文件的绝对路径 
      filename: 'js/[name].[contenthash].js' // 生成打包代码重命名 js[name].js 默认main.js 
     },
};

登入後複製

可能你想要了解在代码最上面导入的 path 模块是什么，它是一个 Node.js 核心模块，用于操作文件路径。

Babel用法

在实际开发中我们很少直接去接触babel，但是babel对于前端开发来说又是必不可少的。Babel到底是什么呢，它其实是一个工具链，跟postcss一样，它能够将ECMAScript后版本语法代码转为ES5代码，包括:语法转换、源代码转换、Polyfill实现功能。

babel核心安装

我们来安装babel核心库@babel/core，如果我们想要在命令行使用需要安装@babel/cli，安装npm install @babel/core @babel/cli。我们如果想使用babel的功能，就需要安装bable的插件，我们可以使用babel的预设插件@babel/preset-env，安装npm install @babel/preset-env -D。

babel.config.js:

module.exports = {
  presets: [
    ["@babel/preset-env", {
      "targets": {
        "browsers": ["last 2 versions"]
      }
    }]
  ]
}

登入後複製

尽管现在市面上主流的浏览器已经适配了es6的语法，但是我觉得js语法降级也是我们需要掌握的；

loader

loader 让 webpack 能够去处理那些非 JavaScript 文件（webpack 自身只理解 JavaScript）。loader 可以将所有类型的文件转换为 webpack 能够处理的有效模块，然后你就可以利用 webpack 的打包能力，对它们进行处理。

本质上，webpack loader 将所有类型的文件，转换为应用程序的依赖图（和最终的 bundle）可以直接引用的模块。

注意，loader 能够 import 导入任何类型的模块（例如 .css 文件），这是 webpack 特有的功能，其他打包程序或任务执行器的可能并不支持。我们认为这种语言扩展是有很必要的，因为这可以使开发人员创建出更准确的依赖关系图。

在更高层面，在 webpack 的配置中 loader 有两个目标：

test 属性，用于标识出应该被对应的 loader 进行转换的某个或某些文件。
use 属性，表示进行转换时，应该使用哪个 loader。

const path = require('path');  // node 提供的方法获取绝对路径
module.exports = {
  mode: 'development', // 开发模式（打包出来的代码不会被压缩）转化为html、css、js，图片压缩等
  entry: './src/main.js', // 项目入口文件（打包这个文件）
  output: {
    path: path.resolve(__dirname,'dist'),  // webpack要求必须要绝对路径,__dirname项目文件的绝对路径
    filename: 'js/[name].[contenthash].js' // 生成打包代码重命名 js[name].js  默认main.js
  },
  module: {
    rules: [
      {
        test: /\.css$/i,  //正则表达式
        use: ['style-loader', 'css-loader']  // 从右向左执行，有先后顺序 
      },
      {
        test: /\.vue$/i,  //正则表达式
        use: ['vue-loader']  // 从右向左执行，有先后顺序 
      },
      {
        test: /\.js$/i,  //正则表达式
        exclude: '/node_modules',
        use: ['babel-loader']
      }
    ]
  }
}

登入後複製

在一般的vue项目中我们需要使用node安装三个loader npm i style-loader、npm i css-loader、npm i vue-loader，同时还需要一个vue的编译插件npm i @vue/compiler-sfc，其作用是将vue的语法编译成抽象语法树（虚拟dom结构），

手把手教你使用webpack實作vue-cli

换句话说就是将.vue文件的三个部分取出来，分别放到`script` 、 `template` 、 `style` 三个部分中去。

插件(plugins)

loader 被用于转换某些类型的模块，而插件则可以用于执行范围更广的任务。插件的范围包括，从打包优化和压缩，一直到重新定义环境中的变量。插件接口功能极其强大，可以用来处理各种各样的任务。

想要使用一个插件，你只需要 require() 它，然后把它添加到 plugins 数组中。多数插件可以通过选项(option)自定义。你也可以在一个配置文件中因为不同目的而多次使用同一个插件，这时需要通过使用 new 操作符来创建它的一个实例。

首先为了打包之后生成一个新的html的文件，我们需要安装一个插件npm i html-webpack-plugin -D该插件将为你生成一个 HTML5 文件,配置文件如下：

const HtmlWebpackPlugin = require('html-webpack-plugin'); // 通过 npm 安装
const path = require('path');  // node 提供的方法获取绝对路径
const { VueLoaderPlugin } = require('vue-loader/dist/index')
const { CleanWebpackPlugin } = require('clean-webpack-plugin')  
module.exports = {
  mode: 'development', // 开发模式（打包出来的代码不会被压缩）转化为html、css、js，图片压缩等
  entry: './src/main.js', // 项目入口文件（打包这个文件）
  output: {
    path: path.resolve(__dirname,'dist'),  // webpack要求必须要绝对路径,__dirname项目文件的绝对路径
    filename: 'js/[name].[contenthash].js' // 生成打包代码重命名 js[name].js  默认main.js
  },
  module: {
    rules: [
      {
        test: /\.css$/i,
        use: ['style-loader', 'css-loader']  // 从右向左执行，有先后顺序 
      },
      {
        test: /\.vue$/i,
        use: ['vue-loader']  // 从右向左执行，有先后顺序 
      },
      {
        test: /\.js$/i,
        exclude: '/node_modules',
        use: ['babel-loader']  // 我们安装的一个插件，使得es6之后的语法转化为es5
      }
    ]
  },
  plugins: [
    new HtmlWebpackPlugin({
      template: path.resolve(__dirname,'./index.html'),  // 需要打包的html文件的绝对路径
      filename: 'index.html',   // 打包之后的文件可以重命名
      title: '手动搭建vue-cli'   //还可以修改打包后的HTML中的title
    }),
    new VueLoaderPlugin(),
    new CleanWebpackPlugin() // 清除上一次打包的内容删除，使得下一次的打包顺利进行
  ]
}

登入後複製

在插件中修改HTML的title，需要在HTML中写一行代码， htmlWebPlugin就是我们在plugin里new出来的实例对象，同时我们之前安装的vue-loader的功能不仅仅是帮我们去读懂.vue后缀的文件，我们也可以当一个插件来使用；首先引入const { VueLoaderPlugin } = require('vue-loader/dist/index')，在plugin里面new一下我们引用的这个构造函数，它的作用是将我们定义过的规则复制并应用到.vue文件相应的语法块中。

模式

通过选择 development开发模式或 production 生产模式之中的一个，来设置 mode 参数，你可以启用相应模式下的 webpack 内置的优化

module.exports = {
  mode: 'production'
};

登入後複製

到现在我们基本的vue-cli的功能已经实现了，但是我们会发现，我们使用vue-cli运行项目的时候我们是直接跑了一个本地端口的服务，所以我们只需要在最后配置一下DevServer

devServer: {
    static: {
      directory: path.join(__dirname, 'dist'),  // 跑起来的服务的文件
    },
    compress: true,  // 是否压缩
    port: 8080,   // 本地开启服务的端口号
    open: true  // 运行服务之后是否自动打开
  }

登入後複製

package.json

{
  "name": "vue-cli",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "webpack",    //我们使用 npm run build 将项目打包至dist文件夹
    "dev": "webpack serve" // 我们使用 npm run dev 将项目运行起来
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "@babel/core": "^7.19.1",
    "@babel/preset-env": "^7.19.1",
    "babel-loader": "^8.2.5",
    "clean-webpack-plugin": "^4.0.0",
    "css-loader": "^6.7.1",
    "html-webpack-plugin": "^5.5.0",
    "style-loader": "^3.3.1",
    "vue": "^3.2.39",
    "webpack": "^5.74.0",
    "webpack-cli": "^4.10.0",
    "webpack-dev-server": "^4.11.1"
  },
  "dependencies": {
    "@vue/compiler-sfc": "^3.2.39",
    "vue-loader": "^17.0.0"
  }
}

登入後複製

完整的webpack.config.js配置文件：

const HtmlWebpackPlugin = require('html-webpack-plugin'); // 通过 npm 安装
const path = require('path');  // node 提供的方法获取绝对路径
const { VueLoaderPlugin } = require('vue-loader/dist/index')
const { CleanWebpackPlugin } = require('clean-webpack-plugin')
module.exports = {
  mode: 'development', // 开发模式（打包出来的代码不会被压缩）转化为html、css、js，图片压缩等
  entry: './src/main.js', // 项目入口文件（打包这个文件）
  output: {
    path: path.resolve(__dirname,'dist'),  // webpack要求必须要绝对路径,__dirname项目文件的绝对路径
    filename: 'js/[name].[contenthash].js' // 生成打包代码重命名 js[name].js  默认main.js
  },
  module: {
    rules: [
      {
        test: /\.css$/i,
        use: ['style-loader', 'css-loader']  // 从右向左执行，有先后顺序 
      },
      {
        test: /\.vue$/i,
        use: ['vue-loader']  // 从右向左执行，有先后顺序 
      },
      {
        test: /\.js$/i,
        exclude: '/node_modules',
        use: ['babel-loader']
      }
    ]
  },
  plugins: [
    new HtmlWebpackPlugin({
      template: path.resolve(__dirname,'./index.html'),
      filename: 'index.html',
      title: '手动搭建vue-cli'
    }),
    new VueLoaderPlugin(),
    new CleanWebpackPlugin()
  ],
  devServer: {
    static: {
      directory: path.join(__dirname, 'dist'),
    },
    compress: true,
    port: 8080,
    open: true
  }
}

登入後複製

实际效果展示：

手把手教你使用webpack實作vue-cli