vue-cli腳手架build目錄下utils.js工具配置文件詳解

// 引入nodejs路徑模塊
var path = require('path')
// 引入config目錄下的index.js配置文件
var config = require('../config')
// 引入extract-text-webpack-plugin插件，用來將css提取到單獨(dú)的css文件中
// 詳情請(qǐng)看(1)
var ExtractTextPlugin = require('extract-text-webpack-plugin')
// exports其實(shí)就是一個(gè)對(duì)象，用來導(dǎo)出方法的最終還是使用module.exports，此處導(dǎo)出assetsPath
exports.assetsPath = function (_path) {
  // 如果是生產(chǎn)環(huán)境assetsSubDirectory就是'static'，否則還是'static'，哈哈哈
  var assetsSubDirectory = process.env.NODE_ENV === 'production'
    ? config.build.assetsSubDirectory
    : config.dev.assetsSubDirectory
  // path.join和path.posix.join的區(qū)別就是，前者返回的是完整的路徑，后者返回的是完整路徑的相對(duì)根路徑
  // 也就是說path.join的路徑是C:a/a/b/xiangmu/b，那么path.posix.join就是b
  return path.posix.join(assetsSubDirectory, _path)
  // 所以這個(gè)方法的作用就是返回一個(gè)干凈的相對(duì)根路徑
}

// 下面是導(dǎo)出cssLoaders的相關(guān)配置
exports.cssLoaders = function (options) {
  // options如果沒值就是空對(duì)象
  options = options || {}
  // cssLoader的基本配置
  var cssLoader = {
    loader: 'css-loader',
    options: {
      // options是用來傳遞參數(shù)給loader的
      // minimize表示壓縮，如果是生產(chǎn)環(huán)境就壓縮css代碼
      minimize: process.env.NODE_ENV === 'production',
      // 是否開啟cssmap，默認(rèn)是false
      sourceMap: options.sourceMap
    }
  }

  // generate loader string to be used with extract text plugin
  function generateLoaders (loader, loaderOptions) {
    // 將上面的基礎(chǔ)cssLoader配置放在一個(gè)數(shù)組里面
    var loaders = [cssLoader]
    // 如果該函數(shù)傳遞了單獨(dú)的loader就加到這個(gè)loaders數(shù)組里面，這個(gè)loader可能是less,sass之類的
    if (loader) {
      loaders.push({
        // 加載對(duì)應(yīng)的loader
        loader: loader + '-loader',
        // Object.assign是es6的方法，主要用來合并對(duì)象的，淺拷貝
        options: Object.assign({}, loaderOptions, {
          sourceMap: options.sourceMap
        })
      })
    }

    // Extract CSS when that option is specified
    // (which is the case during production build)
    // 注意這個(gè)extract是自定義的屬性，可以定義在options里面，主要作用就是當(dāng)配置為true就把文件單獨(dú)提取，false表示不單獨(dú)提取，這個(gè)可以在使用的時(shí)候單獨(dú)配置，瞬間覺得vue作者好牛逼
    if (options.extract) {
      return ExtractTextPlugin.extract({
        use: loaders,
        fallback: 'vue-style-loader'
      })
    } else {
      return ['vue-style-loader'].concat(loaders)
    }
    // 上面這段代碼就是用來返回最終讀取和導(dǎo)入loader，來處理對(duì)應(yīng)類型的文件
  }

  // https://vue-loader.vuejs.org/en/configurations/extract-css.html
  return {
    css: generateLoaders(), // css對(duì)應(yīng) vue-style-loader 和 css-loader
    postcss: generateLoaders(), // postcss對(duì)應(yīng) vue-style-loader 和 css-loader
    less: generateLoaders('less'), // less對(duì)應(yīng) vue-style-loader 和 less-loader
    sass: generateLoaders('sass', { indentedSyntax: true }), // sass對(duì)應(yīng) vue-style-loader 和 sass-loader
    scss: generateLoaders('sass'), // scss對(duì)應(yīng) vue-style-loader 和 sass-loader
    stylus: generateLoaders('stylus'), // stylus對(duì)應(yīng) vue-style-loader 和 stylus-loader
    styl: generateLoaders('stylus') // styl對(duì)應(yīng) vue-style-loader 和 styl-loader 
  }
}

// Generate loaders for standalone style files (outside of .vue)
// 下面這個(gè)主要處理import這種方式導(dǎo)入的文件類型的打包，上面的exports.cssLoaders是為這一步服務(wù)的
exports.styleLoaders = function (options) {
  var output = []
  // 下面就是生成的各種css文件的loader對(duì)象
  var loaders = exports.cssLoaders(options)
  for (var extension in loaders) {
    // 把每一種文件的laoder都提取出來
    var loader = loaders[extension]
    output.push({
      // 把最終的結(jié)果都push到output數(shù)組中，大事搞定
      test: new RegExp('\\.' + extension + '$'),
      use: loader
    })
  }
  return output
}

 const ExtractTextPlugin = require("extract-text-webpack-plugin");
  module.exports = {
    module: {
      rules: [
        {
          test: /\.css$/, //主要用來處理css文件
          use: ExtractTextPlugin.extract({
            fallback: "style-loader", // fallback表示如果css文件沒有成功導(dǎo)入就使用style-loader導(dǎo)入
            use: "css-loader" // 表示使用css-loader從js讀取css文件
          })
        }
      ],
      plugins: [
        new ExtractTextPlugin("styles.css") //表示生成styles.css文件
      ]
    }
  }