[Vue CLI 3] 配置解析之 css.extract

大家還記得我們在老版本中，對於線上環境配置中會把所有的 css 多打成一個檔案：

核心是使用了外掛 extract-text-webpack-plugin，方式如下：

第一步都是載入外掛

const ExtractTextPlugin = require(`extract-text-webpack-plugin`)

這個外掛的描述如下：

Extract text from a bundle, or bundles, into a separate file.

然後配置如下：（省去了 rules 相關的配置）

一般配置 filename 來保證最終生成的 css 檔名

plugins: [
  new ExtractTextPlugin({
      filename: utils.assetsPath(`css/[name].[contenthash].css`)
  })
]

我們可以預先用 vue inspect --plugin extract-css 看看最終生成的配置：

/* config.plugin(`extract-css`) */
new MiniCssExtractPlugin(
  {
    filename: `css/[name].[contenthash:8].css`,
    chunkFilename: `css/[name].[contenthash:8].css`
  }
)

在檔案 @vue/cli-service/lib/config/css.js 中：

最開始需要獲取 vue.config.js 裡面配置的 css.extract：

const isProd = process.env.NODE_ENV === `production`

const {
  extract = isProd
} = options.css || {}

設定一個變數 shouldExtract

const shadowMode = !!process.env.VUE_CLI_CSS_SHADOW_MODE
const shouldExtract = extract !== false && !shadowMode

如果變數 shouldExtract 為 true，呼叫 plugin 方法來生成一個外掛配置：

這裡依賴的外掛為 mini-css-extract-plugin

if (shouldExtract) {
      webpackConfig
        .plugin(`extract-css`)
          .use(require(`mini-css-extract-plugin`), [extractOptions])
}

filename 內部也有一個判斷過程，如果設定了 filenameHashing，它預設是 true:

filenameHashing: true

型別為 boolean：

filenameHashing: joi.boolean()

const filename = getAssetPath(
      options,
      `css/[name]${options.filenameHashing ? `.[contenthash:8]` : ``}.css`
    )

處理 filename 之後，外掛還有一個配置項：chunkFilename

下面就是通過 Object.assign 來生成 extractOptions

const extractOptions = Object.assign({
      filename,
      chunkFilename: filename
    }, extract && typeof extract === `object` ? extract : {})