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'
  }
}