build 文件夹中的 utils.js

//此文件用来配置 assetsPath css-loader 和 vue-style-loader createNotifierCallback
'use strict'
const path = require('path')
const config = require('../config')
const MiniCssExtractPlugin = require('mini-css-extract-plugin') //将CSS提取为独立的文件的插件，对每个包含css的js文件都会创建一个CSS文件
const packageConfig = require('../package.json')

// 导出assetsPath
exports.assetsPath = function (_path) {
  const assetsSubDirectory = process.env.NODE_ENV === 'production' ?
    config.build.assetsSubDirectory :
    config.dev.assetsSubDirectory

  // path.posix是处理跨操作系统 path.join是用拼接路径片
  return path.posix.join(assetsSubDirectory, _path)
}

// 导出lcssLoaders 该cssLoaders是为了下面的styleLoaders服务
exports.cssLoaders = function (options) {
  options = options || {}
  // cssLoader基本配置
  const cssLoader = {
    // css-loader处理css
    loader: 'css-loader',
    options: {
      // 是否开启sourceMap 用来调试
      sourceMap: options.sourceMap
    }
  }
  // postcssLoader基本配置 用来添加浏览器前缀
  const postcssLoader = {
    loader: 'postcss-loader',
    options: {
      sourceMap: options.sourceMap
    }
  }

  // generate loader string to be used with extract text plugin
  function generateLoaders(loader, loaderOptions) {
    // 将上面的cssLoader放在一个数组中
    const loaders = options.usePostCSS ? [cssLoader, postcssLoader] : [cssLoader]
    // 如果该函数传达了loader那就添加到loaders中，该loader可能是less/sass等
    if (loader) {
      loaders.push({
        // loader配置
        loader: loader + '-loader',
        // 参数配置 Object.assign是合并对象
        options: Object.assign({}, loaderOptions, {
          sourceMap: options.sourceMap
        })
      })
    }

    // 当指定该选项时提取CSS (生产构建期间的情况)
    if (options.extract) {
      //提取抽离css
      return [MiniCssExtractPlugin.loader].concat(loaders)
    } else {
      //不提取抽离css
      return ['vue-style-loader'].concat(loaders)
    }
  }

  // https://vue-loader.vuejs.org/en/configurations/extract-css.html
  return {
    css: generateLoaders(),
    postcss: generateLoaders(),
    less: generateLoaders('less'),
    sass: generateLoaders('sass', {
      indentedSyntax: true
    }),
    scss: generateLoaders('sass'),
    stylus: generateLoaders('stylus'),
    styl: generateLoaders('stylus')
  }
}

// 为独立样式文件生成 loader (.vue之外)
exports.styleLoaders = function (options) {
  const output = []
  const loaders = exports.cssLoaders(options)

  for (const extension in loaders) {
    // 该loader是各种css文件生成的loader对象
    const loader = loaders[extension]
    output.push({
      // 用loader处理符合test正则的文件
      test: new RegExp('\.' + extension + '$'),
      use: loader
    })
  }

  return output
}

exports.createNotifierCallback = () => {
  // 发送桌面消息
  const notifier = require('node-notifier')

  return (severity, errors) => {
    if (severity !== 'error') return

    const error = errors[0]
    const filename = error.file && error.file.split('!').pop()

    notifier.notify({
      title: packageConfig.name,
      message: severity + ': ' + error.name,
      subtitle: filename || '',
      icon: path.join(__dirname, 'logo.png')
    })
  }
}