build 文件夹中的 webpack.base.conf.js

// webpack.base.conf.js 基础配置
'use strict'
const path = require('path') // path模块是路径设置
const webpack = require('webpack')
const utils = require('./utils') // 主要处理css-loader
const config = require('../config') // 引入config目录下的index.js配置文件，主要定义一些开发和生产
const vueLoaderConfig = require('./vue-loader.conf') //解决css文件
const MiniCssExtractPlugin = require('mini-css-extract-plugin') // 从css文件中提取css代码到单独的文件中，对css代码进行代码压缩等
const VueLoaderPlugin = require('vue-loader/lib/plugin')
const threadLoader = require('thread-loader') // 多进程打包
const HardSourceWebpackPlugin = require('hard-source-webpack-plugin') // 缓存的方式 webpack5.0会把hard-source-webpack-plugin内置成一个配置。
const prodEnv = require('../config/prod.env')

const WorkerPool = {
  workers: 2,
  workerParallelJobs: 50,
  poolTimeout: 2000,
  poolRespawn: false,
  name: "my-pool"
};

threadLoader.warmup(WorkerPool, ['vue-loader', 'babel-loader']);

function resolve(dir) {
  return path.join(__dirname, '..', dir)
}

// 加载 Eslint ，是否开启 取决于 config 目录下的 index.js 中的 useEslint
const createLintingRule = () => ({
  test: /.(js|vue)$/,
  loader: 'eslint-loader',
  enforce: 'pre',
  include: [resolve('src'), resolve('test')],
  options: {
    formatter: require('eslint-friendly-formatter'),
    emitWarning: !config.dev.showEslintErrorsInOverlay
  }
})


// webpack 四个核心概念：入口（entry）、输出（output）、loader、插件（plugins）


// 将这个文件暴露出去
module.exports = {
  context: path.resolve(__dirname, '../'),

  /**
   *  入口（entry）
   *  入口起点(entry point)指示 webpack 应该使用哪个模块，来作为构建其内部依赖图的开始。entry的值可以是一个字符串也可以是一个数组（会将entry定义的数组文件内容打包到output中定义的文件中），也*  可以是一个json对象（使用于多页面的编译），默认值为 ./src
   */
  entry: {
    app: './src/main.js'
  },

  /**
   *  插件（plugins）
   */
  plugins: [
    new VueLoaderPlugin(),
    new HardSourceWebpackPlugin({
      // 缓存位置
      cacheDirectory: process.env.NODE_ENV === 'development' || !prodEnv.VERSION_CONTROL ? '../node_modules/.cache/hard-source/[confighash]' : '../../node_modules/.cache/hard-source/[confighash]',

      // 记录路径
      recordsPath: process.env.NODE_ENV === 'development' || !prodEnv.VERSION_CONTROL ? '../node_modules/.cache/hard-source/[confighash]/records.json' : '../../node_modules/.cache/hard-source/[confighash]/records.json',
      configHash: function (webpackConfig) {
        // node-object-hash on npm can be used to build this.
        return require('node-object-hash')({
          sort: false
        }).hash(webpackConfig);
      },

      // 当加载器，插件，其他构建时脚本或其他动态依赖项发生更改时，hard-source需要替换缓存以确保输
      // 出正确。environmentHash被用来确定这一点。如果散列与先前的构建不同，则将使用新的缓存
      environmentHash: {
        root: process.cwd(),
        directories: [],
        files: ['package-lock.json', 'yarn.lock'],
      }
    }),
    ...(function () {
      let max = 2
      let res = []
      for (let i = 0; i < max; i++) {
        res.push(new webpack.DllReferencePlugin({
          context: path.resolve(__dirname, '../'),
          manifest: require(resolve(`./dllManifest/xuAdmin${i}-manifest.json`))
        }))
      }
      return res
    })()
  ],

  /** 
   *  输出（output）
   *  output 属性告诉 webpack 在哪里输出它所创建的 bundles，以及如何命名这些文件，默认值为 ./dist。
   */
  output: {
    path: config.build.assetsRoot, // 路径是config目录下的index.js中的build配置中的assetsRoot，也就是dist目录
    filename: '[name].js', // 文件名称这里使用默认的name也就是main

    // 上线地址，也就是真正的文件引用路径，如果是production生产环境，其实这里都是 '/'
    publicPath: process.env.NODE_ENV === 'production' ?
      config.build.assetsPublicPath : config.dev.assetsPublicPath
  },


  /**
   *  解析(resolve) 配置模块如何解析
   */
  resolve: {
    // resolve.extensions 自动解析确定的扩展。默认值为：extensions: [".js", ".json"]
    extensions: ['.js', '.vue', '.json'],

    // resolve.alias 创建 import 或 require 的别名，来确保模块引入变得更简单。
    alias: {
      'vue$': 'vue/dist/vue.esm.js', //后面的$符号指精确匹配，也就是说只能使用 import vuejs from "vue" 这样的方式导入vue.esm.js文件，不能在后面跟上 vue/vue.js
      '@': resolve('src'), //  // resolve('src') 其实在这里就是项目根目录中的src目录，使用 import somejs from "@/some.js" 就可以导入指定文件
    }
  },

  /**
   *  loader
   *  loader 让 webpack 能够去处理那些非 JavaScript 文件（webpack 自身只理解 JavaScript）
   *  对一个单独的 module 对象定义了 rules 属性，里面包含两个必须属性：test 和 use 
   *  这告诉 webpack 编译器(compiler) 如下信息：
   *  “嘿，webpack 编译器，当你碰到「在 require()/import 语句中被解析为 '.vue' 的路径」时，在你对它打包之前，先使用 vue-loader 转换一下。
   */
  module: {
    rules: [{
        test: /.vue$/,
        use: [{
            loader: 'thread-loader',
            options: WorkerPool
          },
          'cache-loader',
          {
            loader: 'vue-loader',
            options: vueLoaderConfig
          }
        ]
      },
      {
        test: /.js$/,
        use: [{
            loader: 'thread-loader',
            options: WorkerPool
          },
          'cache-loader',
          {
            loader: 'babel-loader',
            options: {
              cacheDirectory: true
            }
          }
        ],
        include: [resolve('src'), resolve('test')],
        exclude: /(node_modules)/
      },
      {
        test: /.(png|jpe?g|gif|svg)(?.*)?$/,
        loader: 'url-loader',
        options: {
          limit: 10000,
          esModule: false,
          name: utils.assetsPath('img/[name].[hash:7].[ext]')
        },
        exclude: [resolve('src/icons')],
      },
      {
        test: /.(mp4|webm|ogg|mp3|wav|flac|aac)(?.*)?$/,
        loader: 'url-loader',
        options: {
          limit: 10000,
          esModule: false,
          name: utils.assetsPath('media/[name].[hash:7].[ext]')
        }
      },
      {
        test: /.(woff2?|eot|ttf|otf)(?.*)?$/,
        loader: 'url-loader',
        options: {
          limit: 10000,
          esModule: false,
          name: utils.assetsPath('fonts/[name].[hash:7].[ext]'),
          publicPath: "../../"
        }
      },
      {
        test: /.sass$/,
        use: [process.env.NODE_ENV === 'production' ? MiniCssExtractPlugin.loader : 'style-loader', {
          loader: 'css-loader',
          options: {
            sourceMap: true
          },
        }, "sass-loader"],
        include: [resolve('src'), resolve('test')],
        exclude: /(node_modules)/,
      }
    ]
  },

  node: {
    // prevent webpack from injecting useless setImmediate polyfill because Vue
    // source contains it (although only uses it if it's native).
    setImmediate: false,
    // prevent webpack from injecting mocks to Node native modules
    // that does not make sense for the client
    dgram: 'empty',
    fs: 'empty',
    net: 'empty',
    tls: 'empty',
    child_process: 'empty'
  }
}