JavaScript webpack5 配置及使用基本介绍

作者:资源驿站时间:2026-10-25 19:47:01浏览:631

本文介绍webpack5的基本配置与使用。涵盖入口、出口、loader、插件和模式五大核心概念,并通过简单项目演示如何搭建webpack环境。重点讲解html-webpack-plugin的使用,帮助理解vue-cli等脚手架背后的打包原理。

一、webpack

1.1 简介

在早期前端开发阶段,开发者需手动在HTML中插入script和link标签来引入JS和CSS文件。这种方式不仅操作繁琐,且每个文件都会产生独立的网络请求,还容易引发变量命名冲突。

为解决上述问题,业界提出了JavaScript模块化概念,并相继出现了AMD、CommonJS、CMD以及ES6模块化等多种解决方案。

然而,浏览器原生并不直接支持所有模块化规范。例如,许多npm模块采用CommonJS语法,直接在浏览器中运行会报错。

因此,模块打包工具应运而生。其主要职责是解析模块间的依赖关系,并将项目代码打包转换浏览器可识别的标准JS文件。

目前社区中流行的打包工具包括Webpack、Parcel和Rollup等。

一、webpack

如果你曾使用过vue-cli或create-react-app等脚手架工具,实际上你已经在使用webpack了。这些工具均基于webpack进行二次封装,深入理解webpack原理有助于更好地开发Vue和React项目。

1.2 五大核心概念

项目中webpack的配置文件位于根目录:webpack.config.js

entry (入口)

入口起点(entry point)指示 webpack 应该使用哪个模块,来作为构建其内部依赖图的开始,例如vue项目中的main.js就是打包时的入口文件。

module.exports = {
  entry: './src/main.js'
};

项目中的所有依赖都应该直接或者间接地与入口文件关联起来,例如我们都是在main.js中引入外部模块(axios、router、elementUI等)。

output (出口)

output 属性告诉 webpack 在哪里输出它所创建的 bundles,以及如何命名这些文件,默认值为 ./dist。

const path = require('path');
module.exports = {
  entry: './src/main.js',
  output: {
  	//__dirname是当前目录根目录
    path: path.resolve(__dirname, 'dist'),
    filename: 'bundle.js'
  }
};
  • ouput的path属性决定了打包好的文件的生成位置,默认是./dist,如果没有,webpack会自动创建这个目录。
  • ouput的filename属性决定了打包文件的名称。

loader

loader 让 webpack 能够去处理那些非 JavaScript 文件(例如图片,css文件、vue文件等,webpack 自身只理解 JavaScript)。

loader 可以将所有类型的文件转换为 webpack 能够处理的有效模块,然后你就可以利用 webpack 的打包能力,对它们进行处理。

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

在 webpack 配置中定义 loader 时,要定义在 module.rules 中,其中test属性是需要匹配的文件名的正则,use属性是对应的loader,可以是多个(数组)。

例如上面的style-loader和css-loader就是处理js中引入的css文件(如果直接在js中引入css文件,是会报错的)。

plugin (插件)

oader 被用于转换某些类型的模块,而插件则可以用于执行范围更广的任务。

插件的范围包括,从打包优化和压缩,一直到重新定义环境中的变量,插件增强了webpack的功能。

要使用插件,对于webpack内置的插件,我们通过引入webpack然后直接访问内置插件即可,对于外部插件,我们需要先安装,然后require引入,然后在plugin数组引入插件(new)实例。

const HtmlWebpackPlugin = require('html-webpack-plugin'); // 通过 npm 安装
const webpack = require('webpack'); // 用于访问内置插件
const config = {
  module: {
    rules: [
      //...
    ]
  },
  plugins: [
    new HtmlWebpackPlugin({template: './src/index.html'})
  ]
};
module.exports = config;

上面的html-webpack-plugin插件就是根据模板(template)页面在打包的目录中自动生成一个对应的html文件,并且自动插入打包生成js文件的script标签(正常webpack打包并不会生成html文件)。

mode (模式)

  • 开发模式(development):优化打包速度,优化代码调试。
  • 生产模式(production):优化打包速度,优化代码运行的性能

一、webpack

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

即打包的模式不同,那么webpack对于打包代码的优化策略也不一样。

二、配置及使用

我们来搭建一个非常简单的webpack项目🌈。

项目结构

一、webpack

接着我们创建基本的项目结构和文件☁️。

my-webpack-demo ├── src | └── index.js(入口文件) ├── utils | └── time.js(时间工具) ├── package-lock.json ├── package.json ├── webpack.config.js(webpack配置)

其中utils下的time.js负责生成当前时间 time.js:

var time = new Date();
var m = time.getMonth() + 1;
var t = time.getFullYear() + "-" + m + "-" + time.getDate() + " " + time.getHours() + ":" + time.getMinutes() + ":" + time.getSeconds();
module.exports = {
  now: t,
};

入口文件index.js:

import { now } from "../utils/time.js";
document.write("现在是: " + now);

webpack配置文件webpack.config.js:

module.exports = {
  entry: "./src/index.js",
  mode: "development",
  output: {
    filename: "index.js",
  },
};

我们在终端执行打包命令:

一、webpack

此时webpack自动在项目中创建了dist目录,并生成了打包好的index.js文件,那么我们如何验证index.js文件是否有效呢?

使用html-webpack-plugin

由于webpack并不会自动生成html文件,还记得上面的html-webpack-plugin插件吗?

通过npm安装:

一、webpack

在配置文件中引入:

const HtmlWebpackPlugin = require("html-webpack-plugin"); // 通过 npm 安装
module.exports = {
  entry: "./src/index.js",
  mode: "development",
  output: {
    filename: "index.js",
  },
  plugins: [new HtmlWebpackPlugin({ template: "./src/index.html", scriptLoading: "blocking" })],
};

记得在src下创建index.html模板:

一、webpack

欧克!我们再次执行打包命令npx webpack 🌞。

一、webpack

可以看到,在dist目录下不仅生成了index.js,还有index.html,我们在浏览器中打开它🌤️。

一、webpack

time.js成功生效咯 ⛄!

三、写在最后

我们完成了一个非常简单的webpack项目,你是否发现了这和vue项目的打包流程十分相似呢?

只是vue-cli的功能是十分强大的,例如可以解析vue文件,热更新等等……

所以这也验证了开始说的,vue-cli是对webpack的二次封装,封装了许多loader和plugin,并且配置好了入口,出口等配置信息,我们可以拿来就用。

到此这篇关于JavaScript webpack5配置及使用基本介绍的文章就介绍到这了,更多相关JS webpack5内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!

作者最新文章