Webpack执行build脚本时自动修改index.html的原因咨询

每次执行build脚本（webpack --mode production）时，项目中的index.html会被修改并重新格式化，请问原因是什么？

提供的配置信息 #

package.json 中的scripts部分 #

"scripts": {
  "start": "webpack-dev-server --open --mode development --hot",
  "build": "webpack --mode production",
  "dev-server": "nodemon server/index.js"
},

webpack.config.js 配置 #

const path = require('path');

const DIST_DIR = path.join(__dirname, 'client', 'dist');
const SRC_DIR = path.join(__dirname, 'client', 'src', 'index.jsx');
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
  mode: 'development',
  entry: SRC_DIR,
  devtool: 'inline-source-map',
  output: {
    path: DIST_DIR,
    filename: 'bundle.js',
  },
  devServer: {
    static: './dist',
    historyApiFallback: true
  },
  module: {
    rules: [
      {
        test: /\.jsx?$/,
        exclude: /node_modules/,
        loader: 'babel-loader',
      },
      {
        test: /\.css$/i,
        use: ['style-loader', 'css-loader'],
      },
    ],
  },
  resolve: {
    extensions: ['.jsx', '.ts', '.js'],
  },
  plugins: [
    new HtmlWebpackPlugin({
      template: './client/dist/index.html',
    }),
  ],
};

原因分析 #

问题核心在于HtmlWebpackPlugin的配置逻辑：

• 你将插件的template参数指向了webpack的输出目录（dist）下的index.html，而该目录正是打包产物的存放位置。
• 每次执行build时，HtmlWebpackPlugin会读取这个template文件，然后按照插件默认的HTML格式化规则重新生成新的index.html，并直接覆盖原文件，这就是你看到文件被修改格式化的直接原因。

优化建议 #

将template指向src目录下的原始HTML模板文件（比如./client/src/index.html），而非输出目录中的文件。这样插件会基于源码模板生成dist目录下的index.html，不会破坏你手动维护的文件。

内容的提问来源于stack exchange，提问作者hello_programmers