Webpack 基础入门

懒羊羊我小弟2025-02-20 8:05

一、Webpack 是什么

Webpack 是一款现代 JavaScript 应用程序的静态模块打包工具。在 Web 开发中，我们的项目会包含各种类型的文件，如 JavaScript、CSS、图片等。Webpack 可以将这些文件打包成一个或多个文件，以便在浏览器中高效加载。它就像是一个超级管家，把项目中的各种资源整理打包，让它们能更好地协同工作。

二、为什么要使用 Webpack

  1. 代码拆分：可以将代码拆分成多个块，实现按需加载，提高页面加载速度。比如一个大型项目，有些功能可能不是用户一开始就需要的，Webpack 可以把这些功能代码单独打包，等用户用到时再加载。
  2. 模块加载：支持各种模块加载方式，如 ES6 模块、CommonJS 模块等，统一管理项目中的模块依赖。
  3. 处理不同类型文件：不仅能处理 JavaScript，还能处理 CSS、Sass、Less 等样式文件，以及图片、字体等资源文件。

三、Webpack 基础入门

（一）安装 Webpack

  1. 首先确保你已经安装了 Node.js，因为 Webpack 是基于 Node.js 运行的。
  2. 全局安装 Webpack 和 Webpack - CLI（命令行界面）：
plain 复制代码 
npm install webpack webpack - cli -g

（二）创建项目结构

  1. 创建一个新的文件夹，例如webpack - demo。
  2. 在该文件夹下创建以下文件和文件夹：
    • src文件夹：用于存放源文件，在src文件夹下创建index.js文件。
    • dist文件夹：用于存放打包后的文件，这个文件夹一开始可以不存在，Webpack 会在打包时自动生成。

（三）编写基础代码

在src/index.js中编写如下代码：

js 复制代码 
function add(a, b) {
    return a + b;
}
const result = add(1, 2);
console.log(result);

（四）配置 Webpack

在项目根目录下创建webpack.config.js文件，内容如下：

js 复制代码 
const path = require('path');
module.exports = {
    entry: './src/index.js',
    output: {
        filename: 'bundle.js',
        path: path.resolve(__dirname, 'dist')
    }
};

这里配置了入口文件entry为src/index.js，表示从这个文件开始打包；output指定了打包后的文件名filename为bundle.js，输出路径path为dist文件夹。

（五）执行打包

在命令行中进入项目根目录，执行以下命令：

plain 复制代码 
webpack - - config webpack.config.js

执行成功后，会在dist文件夹下生成bundle.js文件。这个文件就是打包后的文件，包含了src/index.js中的代码以及相关依赖。

四、Webpack 核心功能

（一）加载器（Loaders）

  1. 作用：Webpack 本身只能处理 JavaScript 和 JSON 文件，Loaders 可以让 Webpack 处理其他类型的文件，如 CSS、图片等。
  2. 使用示例 - 加载 CSS 文件 ：
    • 安装css - loader和style - loader：
plain 复制代码 
npm install css - loader style - loader --save - dev
  • 在src文件夹下创建styles.css文件，添加一些简单的样式：
css 复制代码 
body {
    background - color: lightblue;
}
  • 修改src/index.js文件，引入styles.css：
js 复制代码 
import './styles.css';
function add(a, b) {
    return a + b;
}
const result = add(1, 2);
console.log(result);
  • 修改webpack.config.js文件，配置加载器：
js 复制代码 
const path = require('path');
module.exports = {
    entry: './src/index.js',
    output: {
        filename: 'bundle.js',
        path: path.resolve(__dirname, 'dist')
    },
    module: {
        rules: [
            {
                test: /\.css$/,
                use: ['style - loader', 'css - loader']
            }
        ]
    }
};

这里module.rules配置了一个规则，test表示匹配所有.css文件，use指定了使用style - loader和css - loader来处理这些文件。css - loader负责解析 CSS 文件，style - loader负责将解析后的 CSS 插入到 HTML 页面中。

（二）插件（Plugins）

  1. 作用：插件可以扩展 Webpack 的功能，实现更复杂的任务，如代码压缩、生成 HTML 文件、提取 CSS 为单独文件等。
  2. 使用示例 - 使用 HtmlWebpackPlugin 生成 HTML 文件 ：
    • 安装html - webpack - plugin：
plain 复制代码 
npm install html - webpack - plugin --save - dev
  • 修改webpack.config.js文件，添加插件配置：
js 复制代码 
const path = require('path');
const HtmlWebpackPlugin = require('html - webpack - plugin');
module.exports = {
    entry: './src/index.js',
    output: {
        filename: 'bundle.js',
        path: path.resolve(__dirname, 'dist')
    },
    module: {
        rules: [
            {
                test: /\.css$/,
                use: ['style - loader', 'css - loader']
            }
        ]
    },
    plugins: [
        new HtmlWebpackPlugin({
            title: 'Webpack Demo',
            template: './src/index.html'
        })
    ]
};

这里引入了HtmlWebpackPlugin插件，配置了title为页面标题，template指定了使用src/index.html作为模板来生成 HTML 文件。在src文件夹下创建index.html文件：

html 复制代码 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF - 8">
    <title><%= htmlWebpackPlugin.options.title %></title>
</head>
<body>
    <script src="bundle.js"></script>
</body>
</html>

再次执行打包命令，会在dist文件夹下生成一个 HTML 文件，并且自动引入了打包后的bundle.js文件。

  1. 常用插件补充
    • TerserPlugin：用于压缩 JavaScript 代码，减小文件体积，提升加载速度。它是 Webpack 4 + 版本默认的代码压缩插件，无需额外安装。在webpack.config.js中配置如下：
js 复制代码 
const path = require('path');
const HtmlWebpackPlugin = require('html - webpack - plugin');
const TerserPlugin = require('terser - webpack - plugin');
module.exports = {
    entry: './src/index.js',
    output: {
        filename: 'bundle.js',
        path: path.resolve(__dirname, 'dist')
    },
    module: {
        rules: [
            {
                test: /\.css$/,
                use: ['style - loader', 'css - loader']
            }
        ]
    },
    plugins: [
        new HtmlWebpackPlugin({
            title: 'Webpack Demo',
            template: './src/index.html'
        })
    ],
    optimization: {
        minimizer: [
            new TerserPlugin()
        ]
    }
};
  • MiniCssExtractPlugin：将 CSS 从 JavaScript 文件中提取出来，生成单独的 CSS 文件。这在生产环境中很有用，因为浏览器可以单独缓存 CSS 文件。安装命令：
plain 复制代码 
npm install mini - css - extract - plugin --save - dev

在webpack.config.js中配置如下：

js 复制代码 
const path = require('path');
const HtmlWebpackPlugin = require('html - webpack - plugin');
const MiniCssExtractPlugin = require('mini - css - extract - plugin');
module.exports = {
    entry: './src/index.js',
    output: {
        filename: 'bundle.js',
        path: path.resolve(__dirname, 'dist')
    },
    module: {
        rules: [
            {
                test: /\.css$/,
                use: [MiniCssExtractPlugin.loader, 'css - loader']
            }
        ]
    },
    plugins: [
        new HtmlWebpackPlugin({
            title: 'Webpack Demo',
            template: './src/index.html'
        }),
        new MiniCssExtractPlugin({
            filename:'styles.css'
        })
    ]
};
  • CleanWebpackPlugin：在每次打包前清空输出目录，避免残留旧文件。安装命令：
plain 复制代码 
npm install clean - webpack - plugin --save - dev

在webpack.config.js中配置如下：

js 复制代码 
const path = require('path');
const HtmlWebpackPlugin = require('html - webpack - plugin');
const MiniCssExtractPlugin = require('mini - css - extract - plugin');
const { CleanWebpackPlugin } = require('clean - webpack - plugin');
module.exports = {
    entry: './src/index.js',
    output: {
        filename: 'bundle.js',
        path: path.resolve(__dirname, 'dist')
    },
    module: {
        rules: [
            {
                test: /\.css$/,
                use: [MiniCssExtractPlugin.loader, 'css - loader']
            }
        ]
    },
    plugins: [
        new HtmlWebpackPlugin({
            title: 'Webpack Demo',
            template: './src/index.html'
        }),
        new MiniCssExtractPlugin({
            filename:'styles.css'
        }),
        new CleanWebpackPlugin()
    ]
};

（三）代码拆分与按需加载配置

  1. 原理：Webpack 的代码拆分是指将一个大的 JavaScript 文件拆分成多个小的文件，这些小文件可以在需要的时候再加载。按需加载就是在特定的时机（比如用户点击某个按钮、访问某个路由等）才加载对应的代码块，而不是在页面一开始就加载所有代码，从而提高页面的初始加载速度和用户体验。
  2. 基础配置：在 Webpack 4 + 版本中，可以使用splitChunks配置项来实现代码拆分。在webpack.config.js中添加如下配置：
js 复制代码 
const path = require('path');
const HtmlWebpackPlugin = require('html - webpack - plugin');
module.exports = {
    entry: './src/index.js',
    output: {
        filename: 'bundle.js',
        path: path.resolve(__dirname, 'dist'),
        // 为动态导入的代码块指定输出路径和文件名
        chunkFilename: '[name].[chunkhash].js'
    },
    module: {
        rules: [
            {
                test: /\.css$/,
                use: ['style - loader', 'css - loader']
            }
        ]
    },
    plugins: [
        new HtmlWebpackPlugin({
            title: 'Webpack Demo',
            template: './src/index.html'
        })
    ],
    optimization: {
        splitChunks: {
            chunks: 'all'
        }
    }
};

optimization.splitChunks.chunks: 'all'表示对所有类型的 chunk（入口 chunk、异步 chunk 等）都进行代码拆分。这里output.chunkFilename用于指定非入口 chunk（动态导入的代码块）的输出文件名，[name]会被替换为代码块的名称，[chunkhash]会根据代码块内容生成哈希值，用于缓存控制。

  1. 实际应用示例 - 动态导入模块实现按需加载 ：
    • 在src文件夹下创建一个新的文件math.js，编写如下代码：
js 复制代码 
export function multiply(a, b) {
    return a * b;
}
  • 修改src/index.js文件，通过动态导入的方式引入math.js模块：
js 复制代码 
import './styles.css';
function add(a, b) {
    return a + b;
}
const result = add(1, 2);
console.log(result);
// 点击按钮时动态导入math.js模块并调用multiply函数
document.addEventListener('DOMContentLoaded', function () {
    const button = document.createElement('button');
    button.textContent = '点击计算乘法';
    document.body.appendChild(button);
    button.addEventListener('click', function () {
        import('./math.js').then((module) => {
            const product = module.multiply(3, 4);
            console.log('乘法结果:', product);
        });
    });
});

这里使用import('./math.js')动态导入math.js模块，这是 ES2020 引入的动态导入语法，Webpack 会自动将其拆分成一个单独的代码块。当用户点击按钮时，才会加载这个代码块，实现了按需加载。执行打包命令后，在dist文件夹下会生成除了bundle.js之外的math.[chunkhash].js文件，这就是拆分出来的代码块。

五、总结

通过以上步骤，我们对 Webpack 的基础和核心功能有了初步了解。Webpack 还有很多高级特性，如代码优化、热模块替换等，后续可以进一步深入学习。希望这篇文章能帮助大家顺利入门 Webpack，开启高效的 Web 开发之旅。

相关推荐
运维阿江4 分钟前
【小白学HTML5】盒模型_第一讲
前端·html·html5
码界领航17 分钟前
【2025最新版】Chrome谷歌浏览器如何能恢复到之前的旧版本
前端·chrome
乐多_L1 小时前
使用vue3框架vue-next-admin导出表格excel（带图片）
前端·javascript·vue.js
南望无一1 小时前
React Native 0.70.x如何从本地安卓源码(ReactAndroid)构建
前端·react native
Mike_188702783511 小时前
1688代采下单API接口使用指南：实现商品采集与自动化下单
前端·python·自动化
鲨鱼辣椒️面1 小时前
HTML视口动画
前端·html
一小路一1 小时前
Go Web 开发基础：从入门到实战
服务器·前端·后端·面试·golang
堇舟1 小时前
HTML第一节
前端·html
纯粹要努力2 小时前
前端跨域问题及解决方案
前端·javascript·面试
小刘不知道叫啥2 小时前
React源码揭秘 | 启动入口
前端·react.js·前端框架
热门推荐
01DeepSeek各版本说明与优缺点分析02如何在WPS和Word/Excel中直接使用DeepSeek功能03DeepSeek本地部署详细指南04本地部署DeepSeek教程（Mac版本）05本地化部署AI知识库：基于Ollama+DeepSeek+AnythingLLM保姆级教程06DeepSeek r1本地安装全指南07太炸裂了！清华大学deepseek从入门到精通使用手册又出第三版了，《普通人如何抓住DeepSeek红利》（无套路，直接下载）08DeepSeek R1本地化部署 Ollama + Chatbox 打造最强 AI 工具09在Windows下安装Ollama并体验DeepSeek r1大模型10Page Assist - 本地Deepseek模型 Web UI 的安装和使用