02｜Webpack编译搭建：如何用Webpack初构建Vue3项目？

最新推荐文章于 2024-05-08 17:28:57 发布

源码头

最新推荐文章于 2024-05-08 17:28:57 发布

阅读量857

点赞数

分类专栏：前端文章标签： webpack javascript 前端

本文链接：https://blog.csdn.net/sucaiwa/article/details/129268880

版权

前端专栏收录该内容

42 篇文章 4 订阅

订阅专栏

02｜Webpack编译搭建：如何用Webpack初构建Vue 3项目？

你好，我是杨文坚。

看到这个题目，你是不是觉得有点疑惑？明明Vue.js 3官方标配的编译工具是Vite，为什么我不先讲Vue.js 3结合Vite进行项目编译，而是先教你用Webpack编译Vue.js 3项目呢？

这是因为，我们这个课程是要做一个“企业级项目的实战”，而在企业技术开发中，第一要素就是保证功能的稳定性和可用性。在这一点上，Webpack比Vite有更大优势。它发布于2013年，拥有较好的技术生态，基本上，你用Webpack项目打包构建遇到任何问题，都能在网上找到相关场景的直接解决方案或者间接解决思路。而Vite比较年轻，在2020年才发布正式版，在技术生态的沉淀上并没有Webpack那么丰富。

所以，这一讲中，我们还是先来讲讲怎么用Webpack来编译Vue.js 3项目。开始之前，我们先来看看除了Webpack生态更稳定的因素外，Webpack和Vite究竟还有什么区别，让你对这两个工具有更深入的了解。

Webpack和Vite有什么区别？

我在研究技术的时候经常在想，脱离技术的定位来对比技术好坏都是耍流氓。因为每一种流行的技术之所以被人接纳，肯定是有其诞生的定位和开发者的使用定位。所以我们要对比Webpack和Vite，最重要是 对比这两种技术工具的定位。

Webpack和Vite的定位是不一样的，这个连Vite的作者尤雨溪老师都曾经在知乎上回应过。Vite定位是Web“开发工具链”，其内置了一些打包构建工具，让开发者开箱即用，例如预设了Web开发模式直接使用ESM能力，开发过程中可以通过浏览器的ESM能力按需加载当前开发页面的相关资源。

然而，Webpack定位是构建“打包工具”，面向的是前端代码的编译打包过程。Webpack能力很单一，就是提供一个打包构建的能力，如果有特定的构建需要，必须让开发者来选择合适的Loader和Plugin进行组合配置，达到最终的想要的打包效果。比如 Webpack没有内置开发服务，需要引入 webpack-dev-server 才能有开发服务的能力，这个对比Vite就不一样，VIte就直接内置了一个开发服务。

那么，两者的技术能力或者功能有什么异同点呢？

其实这两个工具能提供的技术能力有很大的重叠度或者相似度，基本就是对前端代码进行打包构建处理。区别是Vite内置了很多工具，可以减少很多配置工作量；而Webpack只是简单的打包工具架子，需要开发者一开始准备很多配置处理，不像Vite那样能开箱即用，需要花些功夫进行选择Webpack的Loader和Plugin进行配置。

不过，在对于企业级项目开发中，技术的稳定性当然是大于一切的，你会发现花上半天时间配置一下打包工具，可以减少后续遇到问题的烦恼。

那么，既然Webpack不能像Vite那样子开箱即用的话，我们现在就来学习一下，用Webpack搭建Vue.js 3项目需要有什么步骤。

如何用Webpack搭建Vue.js 3项目?

用Webpack来搭建Vue.js 3项目，我们可以将最初始的项目搭建分成这几个步骤：

项目目录和源码准备；
安装依赖；
配置Webpack的Vue.js 3编译配置；
执行Vue.js 3编译。

第一步就是要先准备好项目目录，如下所示：

.
├── dist/*
├── package.json
├── src
│   ├── app.vue
│   └── index.js
└── webpack.config.js

我给你从上到下介绍一下这个项目目录的结构：

dist，是一个文件夹，为Vue.js 3代码的编译结果目录，最后的编译结果都是前端静态资源文件，例如JavaScript、CSS和HTML等文件；
package.json，是一个JSON文件，为Node.js项目的声明文件，声明了模块依赖、脚本定义和版本名称等内容；
src，是一个文件夹，为Vue.js3项目的源码目录，主要开发的代码内容都放在这个文件夹里；
webpack.config.js，是一个JavaScript文件，是本次Vue.js 3项目核心内容，主要是Webpack配置代码。

我们就在src的文件夹里新增两个Vue.js 3的源码内容，为后续编译做准备。这里是 src/app.vue 的源码内容：

<template>
  <div class="demo">
    <div class="text">Count: {{state.count}}</div>
    <button class="btn" @click="onClick">Add</button>
  </div>
</template>

<script setup>
  import { reactive } from 'vue';
  const state = reactive({
    count: 0
  });
  const onClick = () => {
    state.count ++;
  }
</script>

<style>
.demo {
  width: 200px;
  padding: 10px;
  box-shadow: 0px 0px 9px #00000066;
  text-align: center;
}
.demo .text {
  font-size: 28px;
  font-weight: bolder;
  color: #666666;
}
.demo .btn {
  font-size: 20px;
  padding: 0 10px;
  height: 32px;
  min-width: 80px;
  cursor: pointer;
}
</style>

以下是 src/index.js 项目的入口文件源码：

import { createApp } from 'vue';
import App from './app.vue';

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

当你完成了步骤一的项目目录的结构设计和源码准备后，就可以进行 第二步，安装依赖的npm模块了，也就是安装项目所需要的npm模块。

这里的npm模块分成两种，一种是源码所在的npm模块，另外一种是开发过程中所需要的npm模块。两种npm模块的安装方式都一样，区别就是安装命令要带上不同参数。

以下是安装源码依赖的npm模块：

npm i --save vue

这里源码代码依赖是 Vue.js 的官方源码库，这时候会自动增加依赖声明到 package.json文件的dependencies字段里。

{
  "dependencies": {
    "vue": "^3.2.37"
  }
}

以下是安装项目开发过程中依赖的npm模块：

npm i --save-dev css-loader mini-css-extract-plugin vue-loader webpack webpack-cli

这里是Webpack编译Vue.js 3代码所需要的开发依赖，这时候也会自动新增依赖声明到 package.json文件的devDependencies字段里，跟源码的依赖区分开来。

{
  "devDependencies": {
    "css-loader": "^6.7.1",
    "mini-css-extract-plugin": "^2.6.1",
    "vue-loader": "^17.0.0",
    "webpack": "^5.74.0",
    "webpack-cli": "^4.10.0"
  }
}

当你完成了步骤二的项目依赖安装后，接下来就是这节课配置的关键内容，步骤三的Webpack配置。 在此，我先将完整的Webpack配置内容贴出来，后面再跟你详细讲解每个配置项的作用，你先看看完整的代码：

const path = require('path');
const { VueLoaderPlugin } = require('vue-loader/dist/index')
const MiniCssExtractPlugin = require('mini-css-extract-plugin');

module.exports = {
  mode: 'production',
  entry: {
    'index' : path.join(__dirname, 'src/index.js'),
  },
  output: {
    path: path.join(__dirname, 'dist'),
    filename: '[name].js',
  },
  module: {
    rules: [
      {
        test: /\.vue$/,
        use: [
          'vue-loader'
        ]
      },
      {
        test: /\.(css|less)$/,
        use: [
          MiniCssExtractPlugin.loader,
          'css-loader',
        ]
      },
    ]
  },
  plugins: [
    new VueLoaderPlugin(),
    new MiniCssExtractPlugin({
      filename: '[name].css'
    })
  ],
  externals: {
    'vue': 'window.Vue'
  }
}

我们从上到下一步步分析。

首先看mode，这是声明了Webpack的打包模式是生产的编译模式。这里一般有两种选项，生产（production）和开发（development）模式，这两种模式是企业或者开源项目约定俗成的必备模式。

第二个entry，是声明了Webpack要执行打包构建编译时候从哪个文件开始编译的“入口文件”。而接下来的output，是声明Webpack编译的出口文件，也就是编译结果要放在哪个目录下的哪个文件里，这里我就对应地配置出口目录配置在 dist文件夹里。

再接着是module，这是Webpack打包构建的核心所在，你可以根据自己项目的打包需要，选择对应的打包加载器（Loader）来处理指定的打包文件。这里我们选择了vue-loader和css-loader 就是为了解决项目里Vue.js3源码和Vue.js3源码里的CSS代码的打包编译处理。

然后是plugins，这个是Webpack的插件配置，主要是贯穿Webpack的整个打包的生命周期。这里就需要Vue的加载插件（VueLoaderPlugin）来辅助你在编译Vue.js 3代码时候做相关的编译处理。同时，我们这里也用了CSS的分离插件（MiniCssExtractPlugin），主要是在Webpack打包的生命周期过程中将Vue.js 3源码里的CSS代码分离出单独的CSS文件。

最后是externals，这个是声明在Webpack打包编译过程中，有哪些源码依赖的npm模块需要“排除打包”处理，也就是不做打包整合处理。我们这里就是将Vue.js 3的运行源码进行“排除打包”处理，让代码最终代码依赖的Vue.js 3运行时，从window.Vue全局变量获取。这么做的好处就是通过减少打包的内容来缩短打包时间。

完成以上的三个步骤，接下来就进入最终步骤了，也就是编译脚本配置。 这里我们需要在package.json 里配置好执行脚本，如下所示：

{
  "scripts": {
    "build": "webpack -c ./webpack.config.js"
  }
}

这个编译脚本可以让你在当前目录的命令行工具里，直接执行 npm run build 就可以触发编译操作。执行编译脚本命令后结果如下图所示：

在这里插入图片描述

执行完代码后，会在当前项目的 dist 目录文件夹里，生成最终的Vue.js 3编译结果代码 index.js 和 index.css 文件。其中index.js文件就是核心的Vue.js3源码文件的编译结果，结果如下：

(()=>{"use strict";const e=window.Vue,t={class:"demo"},n={class:"text"},c={__name:"app",setup(c){const o=(0,e.reactive)({count:0}),a=()=>{o.count++};return(c,s)=>((0,e.openBlock)(),(0,e.createElementBlock)("div",t,[(0,e.createElementVNode)("div",n,"Count: "+(0,e.toDisplayString)(o.count),1),(0,e.createElementVNode)("button",{class:"btn",onClick:a},"Add")]))}};(0,e.createApp)(c).mount("#app")})();

你可以从上述代码中看到，由于我把vue模块给external出来成为window.Vue，让编译后的代码变得更加精简。后续代码运行的时候，我们只要在页面加入 Vue.js 3的全局变量脚本，就可以把 node_modules/vue/dist/vue.runtion.global.js 这个文件复制出来引用了。

好了，到这个点，我们终于实现了最基础的Webpack编译Vue.js 3项目。不过，上述的内容只是开始。不知道你有没有发现，上述配置过程只是处理了代码编译，但是实际做项目我们需要一边写代码一边实时编译源码调试，还要实时显示效果，这不仅仅只做一次性的编译操作，而是要分成多种编译模式。

通常我们做企业级前端项目时候，最基本的编译模式有开发模式和生产模式，接下来我们就来讲解一下Webpack开发模式和生产模式的配置。

Webpack开发模式和生产模式

在讲解如何配置Webpack开发模式和生产模式之前，我们要先了解一个概念，Node.js进程的环境变量概念。

Node.js在执行命令脚本时候，如果带上参数 NODE_ENV=production，完整的脚本命令是 NODE_ENV=production webpack -c ./webpack.config.js 。那么 webpack.config.js 文件在执行的时候，可以在 process.env 拿到环境变量 NODE_ENV，也就是可以拿到 process.env.NODE_ENV = production。

这个环境变量有什么作用呢？它可以让我们设置不同环境变量来执行同一份配置Webpack.config.js 配置文件，触发不同的编译模式。

到这里，你应该知道为什么我一开始要讲解Node.js进程的环境变量这个概念了吧？我们就是要利用进程环境变量，在webpack.config.js配置文件里，根据不同环境变量值判断和处理不同模式的编译。

现在我们就可以开始进入Webpack的开发模式和生产模式的讲解了。

开发模式处理

开发模式和生产模式是基于不同进程环境变量做区分的，所以他们的执行命令脚本就不一样。这里我们就可以基于上述的package.json做一下执行脚本的更改，如下所示：

{
  "scripts": {
    "dev": "NODE_ENV=development webpack serve -c ./webpack.config.js",
    "build": "NODE_ENV=production webpack -c ./webpack.config.js"
  }
}

你有没有发现，这里的开发模式（dev），是不是多了个 serve 的子命令？这个就是我们要讲的在开发模式下，需要一个开发服务来让编译的代码能在浏览器中访问。这个时候，我们就需要安装Webpack开发服务的依赖模块 webpack-dev-server ：

npm i --save-dev webpack-dev-server

你安装后，要在Webpack配置文件添加对应的服务配置：

{
  // 其它 Webpack配置代码
  devServer: {
    static: {
      directory: path.join(__dirname),
    },
    compress: true,
    port: 6001,
    hot: false,
    compress: false,
  }
  // 其它 Webpack配置代码
}

在开发模式下，我们还要断点到源码指定位置的内容，这里就需要新增一个配置内容，也就是sourceMap的配置，配置代码如下所示：

{
  // 其它 Webpack配置代码
  devtool: 'inline-cheap-module-source-map',
  // 其它 Webpack配置代码
}

这里的devtool还有其它的选项，详情你可以参考下官方文档。

另外，开发过程中还需要HTML页面来承载运行编译后的JavaScript和CSS代码。这里你需要在项目的根目录下新创建一个HTML文件 index.html，用于访问处理，同时还需要让 webpack-dev-server知道它应该访问哪个HTML文件的配置处理。为此，你需要先配置好服务的访问页面。

配置服务的访问页面，首先你要安装 html-webpack-plugin 插件来处理HTML页面：

npm i --save-dev html-webpack-plugin

再配置 html-webpack-plugin 到 webpack.confg.js 文件中：

{
  // 其它 Webpack配置代码
  plugins: [
    new HtmlWebpackPlugin({
      title: 'Hello Vue',
      filename: 'index.html',
      template:'./index.html',
      minify: false,
      inject: false,
      templateParameters: {
        publicPath: path.join(__dirname),
        js: [
          './node_modules/vue/dist/vue.runtime.global.js',
          './index.js'
        ],
        css: [
          './index.css'
        ],
      },
    })
  ]
  // 其它 Webpack配置代码
}

然后再配置HTML模板文件：

<html>
  <head>
    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0">
    <link rel="stylesheet" href="<%= htmlWebpackPlugin.options.templateParameters.css[0] %>" />
    <script src="<%= htmlWebpackPlugin.options.templateParameters.js[0] %>"></script>
  </head>
  <body>
    <div id="app"></div>
  </body>
  <script src="<%= htmlWebpackPlugin.options.templateParameters.js[1] %>"></script>
</html>

至此，你就可以愉快地使用开发模式进行Vue.js 3的项目开发了，执行以下命令：

npm run dev

再访问命令行所提示的访问链接，你就可以在浏览器预览到实际代码渲染结果了。

生产模式处理

好了，处理完开发模式后，我们接下来还要处理生产模式。

生产模式最重要的是 代码编译完后要进行压缩处理，减少体积。这里我们就需要压缩JavaScript和CSS的结果代码，你可以选择安装Webpack生态里的压缩代码插件，具体有压缩JavaScript代码的插件TerserPlugin和压缩CSS代码的插件 CssMinimizerPlugin，这几个插件是Webpack官方文档的推荐插件，可以执行如下安装命令：

npm i --save-dev css-minimizer-webpack-plugin terser-webpack-plugin

然后再进行webpack.config.js 文件的配置：

{
  // 其它 Webpack配置代码
  optimization: {
    minimizer: [
      new TerserPlugin({}),
      new CssMinimizerPlugin({}),
    ],
  },
  // 其它 Webpack配置代码
}

如果这个时候，你还想把HTML模板在生产模式中都打印出来，可以这么配置处理：

{
  // 其它 Webpack配置代码
  plugins: [
    new HtmlWebpackPlugin({
      title: 'Hello Vue',
      filename: 'index.html',
      template:'./index.html',
      minify: false,
      inject: false,
      templateParameters: {
        publicPath: path.join(__dirname),
        js: [
          'https://unpkg.com/vue@3.2.37/dist/vue.runtime.global.js',
          './index.js'
        ],
        css: [
          './index.css'
        ],
      },
    })
  ]
  // 其它 Webpack配置代码
}

注意了，这里的 https://unpkg.com/vue@3.2.37/dist/vue.runtime.global.js 只是临时模拟CDN的Vue.js 3运行时文件，实际企业级项目要换成公司内部的CDN资源。

好了，我这里就已经把Webpack编译Vue.js3项目的生产模式和开发模式都配置好了。不知道你有没有发现，两种模式有很多配置是重叠的，这个时候就需要用到我们刚刚提到的Node.js进程环境变量来做区分判断处理，同时可以加上一个 webpack-merge 来辅助处理配置的合并。

最终配置结果如下所示：

const path = require('path');
const webpackMerge = require('webpack-merge').default;
const { VueLoaderPlugin } = require('vue-loader/dist/index')
const MiniCssExtractPlugin = require('mini-css-extract-plugin');
const CssMinimizerPlugin = require("css-minimizer-webpack-plugin");
const TerserPlugin = require("terser-webpack-plugin");
const HtmlWebpackPlugin = require('html-webpack-plugin');

const baseConfig = {
  mode: process.env.NODE_ENV,
  entry: {
    'index' : path.join(__dirname, 'src/index.js'),
  },
  output: {
    path: path.join(__dirname, 'dist'),
    filename: '[name].js',
  },
  module: {
    rules: [
      {
        test: /\.vue$/,
        use: [
          'vue-loader'
        ]
      },
      {
        test: /\.(css|less)$/,
        use: [
          MiniCssExtractPlugin.loader,
          'css-loader',
        ]
      },
      {
        test: /\.(png|svg|jpg|jpeg|gif)$/i,
        type: 'asset/resource',
      }
    ]
  },
  plugins: [
    new VueLoaderPlugin(),
    new MiniCssExtractPlugin({
      filename: '[name].css'
    }),
  ],
  externals: {
    'vue': 'window.Vue'
  }
}

if (process.env.NODE_ENV === 'development') {
  config = webpackMerge(baseConfig, {
    devtool: 'inline-cheap-module-source-map',
    devServer: {
      static: {
        directory: path.join(__dirname),
      },
      compress: true,
      port: 6001,
      hot: false,
      compress: false,
    },
    plugins: [
      new HtmlWebpackPlugin({
        title: 'Hello Vue',
        filename: 'index.html',
        template:'./index.html',
        minify: false,
        inject: false,
        templateParameters: {
          publicPath: path.join(__dirname),
          js: [
            './node_modules/vue/dist/vue.runtime.global.js',
            './index.js'
          ],
          css: [
            './index.css'
          ],
        },
      })
    ]
  })
} else {
  config = webpackMerge(baseConfig, {
    optimization: {
      minimizer: [
        new TerserPlugin({}),
        new CssMinimizerPlugin({}),
      ],
    },
    plugins: [
      new HtmlWebpackPlugin({
        title: 'Hello Vue',
        filename: 'index.html',
        template:'./index.html',
        minify: false,
        inject: false,
        templateParameters: {
          publicPath: path.join(__dirname),
          js: [
            'https://unpkg.com/vue@3.2.37/dist/vue.runtime.global.js',
            './index.js'
          ],
          css: [
            './index.css'
          ],
        },
      })
    ]
  })
}

module.exports = config;

上述的配置内容就是本次Vue.js 3项目配置Webpack编译的核心代码，涵盖了开发模式和生产模式。现在你应该已经比较清晰地了解到一个完整的Vue.js 3项目的Webpack配置流程了，接下来就愉快地进行Vue.js 3代码的开发吧！

总结

这节课我们讲了这么多关于Webpack的Vue.js 3项目编译配置的知识，核心展示了企业级项目是怎么做编译配置的。

用Webpack搭建Vue.js 3项目，主要包括配置项目目录、根据要求安装依赖（Plugin和Loader）、开发模式和生产模式的设置这几个步骤，其中你要特别注意开发模式和生产模式的配置复用和配置隔离。

我们前面也说了，我们选择Webpack，是为了面向企业级项目的学习目标考虑。目前我所接触到的大厂，主流的构建配置还是Webpack，除了生态丰富的原因外，还有一点是企业中很多历史项目都是用Webpack进行构建的，形成了一个比较稳定的代码传承。但是，你也不能因为这样就忽略了Vite这个Vue.js 3官方的“亲儿子”技术工具。

你需要的是举一反三，用Webpack生产和开发模式配置，类比学习Vite相关的技术知识点，因为同类型的技术基本都是相同的。例如，本节课提到生产和开发模式，就不是Webpack独有的概念，是大部分构建工具都有的概念，Vite也有相关概念。不仅仅是这节课，我希望你后续技术学习都要学会举一反三，互相比对。

思考题

Webpack从诞生到现在这么久，核心也迭代了很多大版本，那不同版本在打包构建上有什么差异吗？

期待你的分享。如果今天的课程让你有所收获，欢迎你把文章分享给有需要的朋友，我们下节课再见！

完整的代码在这里

源码头

关注

0
点赞
踩
2

收藏

觉得还不错? 一键收藏
打赏
0
评论
02｜Webpack编译搭建：如何用Webpack初构建Vue3项目？

这节课我们讲了这么多关于Webpack的Vue.js 3项目编译配置的知识，核心展示了企业级项目是怎么做编译配置的。用Webpack搭建Vue.js 3项目，主要包括配置项目目录、根据要求安装依赖（Plugin和Loader）、开发模式和生产模式的设置这几个步骤，其中你要特别注意开发模式和生产模式的配置复用和配置隔离。我们前面也说了，我们选择Webpack，是为了面向企业级项目的学习目标考虑。
复制链接

扫一扫