基于Webpack 3.x的多页面应用构建实践
本文介绍在Webpack 3.x环境下构建多页面应用(MPA)的核心思路。通过动态生成多个Entry入口、利用html-webpack-plugin生成对应HTML文件,以及使用extract-text-webpack-plugin独立抽取各页面CSS,实现模块化的多页构建方案。文章结合mulXc-cli项目结构,详细解析setting.js与style.js的配置逻辑,适合希望从单页转向多页架构的开发者参考。
Webpack多页面应用构建概述
前言
此前曾基于vue2.x与webpack3.x开发过一个Vue单页应用(SPA)脚手架项目。
该Vue版SPA脚手架项目
有兴趣的读者可以查阅,项目内附有详细注释,非常适合初学者学习Webpack的基础用法。
此外还有React版的SPA脚手架项目
然而在某些业务场景下,单页应用往往难以满足需求,因此衍生出了
mulXc-cli
接下来直接切入主题。
项目文件结构与核心思路
文件结构
├── build 构建服务和webpack配置
├──── build.js 构建全量压缩包 (打包项目)
├──── setting.js 多页面入口配置
├──── style.js 页面1对1抽取生成css文件
├──── utils.js 工具类
├──── webpack.base.conf.js webpack通用配置
├──── webpack.dev.conf.js webpack开发环境配置
├──── webpack.prod.conf.js webpack生产环境配置
├── config webpack开发/生产环境部分配置
├── dist 项目打包目录
├── package.json 项目配置文件
├── src 项目目录
├──── common 多页面公用方法与css
├──── about about页面
├──── home home页面
核心思路
多页面应用(MPA)的定义即包含多个独立页面。
从Webpack的配置视角来看,主要涉及以下三点:
首先,配置多个入口(entry),每个页面对应一个独立的JS资源入口。
其次,生成多个HTML实例,通过html-webpack-plugin插件为每个页面生成对应的HTML文件。
最后,确保每个页面拥有独立的CSS文件,利用extract-text-webpack-plugin插件将CSS从JS中抽取出来。
完成上述配置后,多页面应用的基本要素即已具备,开始具体实现。
入口配置与HTML生成实现
入口配置与HTML页面生成
根据前述文件结构,多页面入口配置及HTML生成逻辑位于build/setting.js文件中。
setting.js文件内容
//node 文件操作模块
const fs = require('fs');
//node 路径模块
const path = require('path');
//使用node.js 的文件操作模块来获取src文件夹下的文件夹名称 ->[about,common,home]
const entryFiles = fs.readdirSync(path.resolve(__dirname, '../src'));
//生成html文件插件
const HtmlWebpackPlugin = require('html-webpack-plugin');
//工具类提取_resolve方法
const { _resolve } = require('./utils');
//入口文件过滤common文件夹(因为common文件夹我们用来存放多页面之间公用的方法与css,所以不放入入口进行构建!)
const rFiles = entryFiles.filter(v => v != 'common');
module.exports = {
//构建webpack入口
entryList: () => {
const entryList = {};
rFiles.map(v => {
entryList[v] = _resolve(`../src/${v}/index.js`);
});
return entryList;
},
//src文件夹下的文件夹名称 ->[about,common,home]
entryFiles: entryFiles,
//使用html-webpack-plugin生成多个html页面.=>[home.html,about.html]
pageList: () => {
const pageList = [];
rFiles.map(v => {
pageList.push(
new HtmlWebpackPlugin({
template: _resolve(`../src/${v}/index.html`),
filename: _resolve(`../dist/${v}.html`),
chunks: ['common', v],
//压缩配置
minify: {
//删除Html注释
removeComments: true,
//去除空格
collapseWhitespace: true,
//去除属性引号
removeAttributeQuotes: true
},
chunksSortMode: 'dependency'
})
);
});
return pageList;
}
};
webpack.base.conf.js基础配置
//引入setting.js 入口配置方法,与html生成配置
const { entryList, pageList } = require('./setting.js');
const baseConf = {
entry: entryList(),
plugins: [...pageList()]
};
CSS独立抽取与生产配置
CSS文件生成逻辑
根据文件结构,CSS文件的生成逻辑位于build/style.js文件中。
style.js文件内容
const path = require('path');
//抽取css文件插件
const ExtractTextPlugin = require('extract-text-webpack-plugin');
//引入入口配置
const { entryList, entryFiles } = require('./setting.js');
//多个ExtractTextPlugin实例
const plugins = [];
entryFiles.map(v => {
plugins.push(
new ExtractTextPlugin({
filename: `css/${v}.[contenthash].css`,
allChunks: false
})
);
});
module.exports = {
//使用正则匹配到每个页面对应style文件夹下的css/less文件,并配置loader来进行解析.从而实现html<->css 1对1
rulesList: () => {
const rules = [];
entryFiles.map((v, k) => {
rules.push({
test: new RegExp(`src(\\\\|\/)${v}(\\\\|\/)style(\\\\|\/).*\.(css|less)$`),
use: plugins[k].extract({
fallback: 'style-loader',
use: ['css-loader', 'postcss-loader', 'less-loader']
})
});
});
return rules;
},
//插件实例
stylePlugins: plugins
};
webpack.prod.conf.js生产环境配置
//引入方法
const { rulesList, stylePlugins } = require('./style.js');
const prodConf = {
module: {
rules: [...rulesList()]
},
plugins: [...stylePlugins]
};
以上内容即为本文的全部介绍,希望对读者有所帮助,欢迎继续支持本站。
Mock.js 与 MSW、YApi 对比:前端接口模拟工具怎么选
2026-11-04 22:55:05
Turf.js 安装与引入:NPM 打包及 CDN 快速上手指南
2026-11-03 23:23:32
JS代码混淆后无法调试?Source Map配置与浏览器断点技巧
2026-11-03 14:12:17
前端JS发送HTTP请求遇到跨域(CORS)报错怎么解决
2026-11-02 10:30:07
Three.js怎么安装:npm引入与CDN加载方法
2026-11-02 09:23:52








