vue-cli 目录结构详细讲解总结(3)

var utils = require('./utils')
var webpack = require('webpack')
var config = require('../config')
// webpack-merge是一个可以合并数组和对象的插件
var merge = require('webpack-merge')
var baseWebpackConfig = require('./webpack.base.conf')
// html-webpack-plugin用于将webpack编译打包后的产品文件注入到html模板中
// 即自动在index.html里面加上<link>和<script>标签引用webpack打包后的文件
var HtmlWebpackPlugin = require('html-webpack-plugin')
// friendly-errors-webpack-plugin用于更友好地输出webpack的警告、错误等信息
var FriendlyErrorsPlugin = require('friendly-errors-webpack-plugin')

// add hot-reload related code to entry chunks
// 给每个入口页面(应用)加上dev-client，用于跟dev-server的热重载插件通信，实现热更新
Object.keys(baseWebpackConfig.entry).forEach(function (name) {
 baseWebpackConfig.entry[name] = ['./build/dev-client'].concat(baseWebpackConfig.entry[name])
})

module.exports = merge(baseWebpackConfig, {
 module: {
  // 样式文件的处理规则，对css/sass/scss等不同内容使用相应的styleLoaders
  // 由utils配置出各种类型的预处理语言所需要使用的loader，例如sass需要使用sass-loader
  rules: utils.styleLoaders({ sourceMap: config.dev.cssSourceMap })
 },
 // cheap-module-eval-source-map is faster for development
 // 使用这种source-map更快
 devtool: '#cheap-module-eval-source-map',
 // webpack插件
 plugins: [
  new webpack.DefinePlugin({
   'process.env': config.dev.env
  }),
  // 开启webpack热更新功能
  new webpack.HotModuleReplacementPlugin(),
  // webpack编译过程中出错的时候跳过报错阶段，不会阻塞编译，在编译结束后报错
  new webpack.NoEmitOnErrorsPlugin(),
  // 自动将依赖注入html模板，并输出最终的html文件到目标文件夹
  new HtmlWebpackPlugin({
   filename: 'index.html',
   template: 'index.html',
   inject: true
  }),
  new FriendlyErrorsPlugin()
 ]
})

// 引入nodejs路径模块
var path = require('path')
// 引入config目录下的index.js配置文件
var config = require('../config')
// 引入extract-text-webpack-plugin插件，用来将css提取到单独的css文件中
// 详情请看(1)
var ExtractTextPlugin = require('extract-text-webpack-plugin')
// exports其实就是一个对象，用来导出方法的最终还是使用module.exports，此处导出assetsPath
exports.assetsPath = function (_path) {
 // 如果是生产环境assetsSubDirectory就是'static'，否则还是'static'，哈哈哈
 var assetsSubDirectory = process.env.NODE_ENV === 'production'
  ? config.build.assetsSubDirectory
  : config.dev.assetsSubDirectory
 // path.join和path.posix.join的区别就是，前者返回的是完整的路径，后者返回的是完整路径的相对根路径
 // 也就是说path.join的路径是C:a/a/b/xiangmu/b，那么path.posix.join就是b
 return path.posix.join(assetsSubDirectory, _path)
 // 所以这个方法的作用就是返回一个干净的相对根路径
}
 
// 下面是导出cssLoaders的相关配置
exports.cssLoaders = function (options) {
 // options如果没值就是空对象
 options = options || {}
 // cssLoader的基本配置
 var cssLoader = {
  loader: 'css-loader',
  options: {
   // options是用来传递参数给loader的
   // minimize表示压缩，如果是生产环境就压缩css代码
   minimize: process.env.NODE_ENV === 'production',
   // 是否开启cssmap，默认是false
   sourceMap: options.sourceMap
  }
 }
 
 // generate loader string to be used with extract text plugin
 function generateLoaders (loader, loaderOptions) {
  // 将上面的基础cssLoader配置放在一个数组里面
  var loaders = [cssLoader]
  // 如果该函数传递了单独的loader就加到这个loaders数组里面，这个loader可能是less,sass之类的
  if (loader) {
   loaders.push({
    // 加载对应的loader
    loader: loader + '-loader',
    // Object.assign是es6的方法，主要用来合并对象的，浅拷贝
    options: Object.assign({}, loaderOptions, {
     sourceMap: options.sourceMap
    })
   })
  }
 
  // Extract CSS when that option is specified
  // (which is the case during production build)
  // 注意这个extract是自定义的属性，可以定义在options里面，主要作用就是当配置为true就把文件单独提取，false表示不单独提取，这个可以在使用的时候单独配置，瞬间觉得vue作者好牛逼
  if (options.extract) {
   return ExtractTextPlugin.extract({
    use: loaders,
    fallback: 'vue-style-loader'
   })
  } else {
   return ['vue-style-loader'].concat(loaders)
  }
  // 上面这段代码就是用来返回最终读取和导入loader，来处理对应类型的文件
 }
 
 // https://vue-loader.vuejs.org/en/configurations/extract-css.html
 return {
  css: generateLoaders(), // css对应 vue-style-loader 和 css-loader
  postcss: generateLoaders(), // postcss对应 vue-style-loader 和 css-loader
  less: generateLoaders('less'), // less对应 vue-style-loader 和 less-loader
  sass: generateLoaders('sass', { indentedSyntax: true }), // sass对应 vue-style-loader 和 sass-loader
  scss: generateLoaders('sass'), // scss对应 vue-style-loader 和 sass-loader
  stylus: generateLoaders('stylus'), // stylus对应 vue-style-loader 和 stylus-loader
  styl: generateLoaders('stylus') // styl对应 vue-style-loader 和 styl-loader 
 }
}
 
// Generate loaders for standalone style files (outside of .vue)
// 下面这个主要处理import这种方式导入的文件类型的打包，上面的exports.cssLoaders是为这一步服务的
exports.styleLoaders = function (options) {
 var output = []
 // 下面就是生成的各种css文件的loader对象
 var loaders = exports.cssLoaders(options)
 for (var extension in loaders) {
  // 把每一种文件的laoder都提取出来
  var loader = loaders[extension]
  output.push({
   // 把最终的结果都push到output数组中，大事搞定
   test: new RegExp('\\.' + extension + '$'),
   use: loader
  })
 }
 return output
}