Webpack5 多页面应用（MPA）构建实践：统一目录与独立部署方案

dist/
├── test1.html
├── test2.html
├── js/
│   ├── test1.[hash].js
│   └── test2.[hash].js
└── 图片、字体等资源

const path = require("path");
const glob = require("glob");
const { merge } = require("webpack-merge");
const HtmlWebpackPlugin = require("html-webpack-plugin");
 
const resolve = (dir) => path.resolve(__dirname, "..", dir);
 
// 打包排除某些依赖
const externals = {
  vue: "Vue",
  vuex: "Vuex",
  "vue-router": "VueRouter",
  axios: "axios",
  vant: "vant",
};
 
// cdn资源
const assetsCDN = {
  // 开发环境
  dev: {
    css: ["//xxx/npm/vant@2.12/lib/index.css"],
    js: ["//xxx/npm/eruda@2.4/eruda.min.js"],
  },
  // 生产环境
  build: {
    css: ["//xxx/npm/vant@2.12/lib/index.css"],
    js: [
      "//xxx/npm/vue@2.6/dist/vue.min.js",
      "//xxx/npm/vuex@3.6/dist/vuex.min.js",
      "//xxx/npm/vue-router@3.5/dist/vue-router.min.js",
      "//xxx/npm/axios@0.21/dist/axios.min.js",
      "//xxx/npm/vant@2.12/lib/vant.min.js",
    ],
  },
};
 
const entryCDN = {
  test: {
    dev: merge(assetsCDN.dev, {
      css: [],
      js: ["//res.wx.qq.com/open/js/jweixin-1.6.0.js"],
    }),
    build: merge(assetsCDN.build, {
      css: [],
      js: ["//res.wx.qq.com/open/js/jweixin-1.6.0.js"],
    }),
  },
};
 
const getEntry = () => {
  // 多页面打包的入口集合
  const entries = {};
  // 多页面打包的模板集合
  const plugins = [];
  // 借助 glob 获取 src 目录下的所有入口文件
  const globPath = resolve("src/views/**/main.js");
  // 遍历文件集合，生成所需要的 entries、plugins 集合
  glob.sync(globPath).map((item) => {
    const match = item.match(/src/views/(.*)/main.js$/);
    const name = match?.[1];
    entries[name] = [item];
    // CDN配置
    const env = process.env.NODE_ENV === "production" ? "build" : "dev";
    const pageCDN = (entryCDN[name] && entryCDN[name][env]) || assetsCDN[env];
    if (!entryCDN[name]) {
      console.warn(`页面 ${name} 未配置 entryCDN，已使用默认配置`);
    }
    // 多页面所需要的模板集合
    plugins.push(
      new HtmlWebpackPlugin({
        title: "",
        filename: `${name}.html`,
        template: "public/index.html",
        favicon: "public/favicon.ico",
        chunks: [name],
        minify:
          process.env.NODE_ENV === "production"
            ? {
                //压缩HTML文件
                removeComments: true, // 移除HTML中的注释
                collapseWhitespace: true, // 删除空白符和换行符
              }
            : false,
        cdn: process.env.NODE_ENV === "production" ? entryCDN[name].build : entryCDN[name].dev,
      })
    );
  });
  // 对外输出页面打包需要的 入口集合、依赖过滤
  return { entries, plugins, externals };
};
 
module.exports = getEntry();

const { entries, plugins, externals } = require("./entry");
 
entry: {
  base: ["core-js/stable", "regenerator-runtime/runtime"],
  ...entries
}

dist/
├── test1/
│   ├── index.html
│   └── js/
│       └── test1.[hash].js
└── test2/
    ├── index.html
    └── js/
        └── test2.[hash].js

// 在多页面统一目录的基础上新增配置
const CopyWebpackPlugin = require("copy-webpack-plugin");
 
const getEntry = () => {
  // 多页面打包的入口集合
  const entries = {};
  // 多页面打包的模板集合
  const plugins = [];
  // 借助 glob 获取 src 目录下的所有入口文件
  const globPath = resolve("src/views/**/main.js");
  const base = ["core-js/stable", "regenerator-runtime/runtime"];
  // 遍历文件集合，生成所需要的 entries、plugins 集合
  glob.sync(globPath).map(item => {
    const match = item.match(/src/views/(.*)/main.js$/);
    const name = match?.[1];
    entries[name] = [...base, item];
 
    const env = process.env.NODE_ENV === "production" ? "build" : "dev";
    const pageCDN = (entryCDN[name] && entryCDN[name][env]) || assetsCDN[env];
 
    if (!entryCDN[name]) {
      console.warn(`页面 ${name} 未配置 entryCDN，已使用默认配置`);
    }
 
    // 多页面所需要的模板集合
    plugins.push(
      new HtmlWebpackPlugin({
        title: "",
        filename: `${name}/index.html`,
        template: "public/index.html",
        // favicon: "public/favicon.ico",
        chunks: [name],
        minify:
          process.env.NODE_ENV === "production"
            ? {
                //压缩HTML文件
                removeComments: true, // 移除HTML中的注释
                collapseWhitespace: true // 删除空白符和换行符
              }
            : false,
        cdn: pageCDN
      }),
      new CopyWebpackPlugin({
        patterns: [{ from: "public/favicon.ico", to: `${name}/favicon.ico` }]
      })
    );
  });
 
  // 对外输出页面打包需要的 入口集合、依赖过滤
  return { entries, plugins, externals };
};

// 1. 注释掉 entry base 的配置
// 2. css、img、font的filename 增加 [name]/
 
splitChunks: false // ❌ 禁用公共拆包