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

原文地址：https://segmentfault.com/a/1190000016390112
<article class="article fmt article-content " style="box-sizing: border-box; display: block; line-height: 1.6; margin-bottom: 1.31rem; color: rgb(33, 37, 41); font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", "Liberation Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; font-size: 16px; font-style: normal; font-variant-ligatures: normal; font-variant-caps: normal; font-weight: 400; letter-spacing: normal; orphans: 2; text-align: left; text-indent: 0px; text-transform: none; white-space: normal; widows: 2; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration-style: initial; text-decoration-color: initial;">

大家还记得我们在老版本中，对于线上环境配置中会把所有的 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 : {})

</article>

vue.jsvue-cli前端webpackjavascript