vue 脚手架初始化项目中配置文件webpack.base.conf.js代码含义

'use strict'
//引入node.js路劲模块
const path = require('path')
//引入utils工具模块，utils主要用来处理css-loader和vue-style-loader的
const utils = require('./utils')
//引入config目录下的index.js配置文件，主要来定义一些开发和生产环境的属性
const config = require('../config')
//vue-loader.conf配置文件是用来解决各种CSS文件的，定义了诸如css,less,sass之类的和样式有关的loader
const vueLoaderConfig = require('./vue-loader.conf')
//此函数是用来返回目前目录的平行目录的路径，因为有个'..'
function resolve (dir) {
  return path.join(__dirname, '..', dir)
}
//eslint 的检测规则
const createLintingRule = () => ({
   //对js和vue 文件进行eslint 检查
  test: /.(js|vue)$/,
  //使用eslint-loader
  loader: 'eslint-loader',
  //enforce执行的意思 有两个值 pre post
    //pre是在其他规则执行之前执行 post是在其他规则执行之后执行
  enforce: 'pre',
  //进行检测的文件目录包括哪些 调用了路径函数，
  include: [resolve('src'), resolve('test')],
  options: {
    //使用第三方的插件进行eslint 检测
    formatter: require('eslint-friendly-formatter'),
    //是否输出eslint报错信息
    emitWarning: !config.dev.showEslintErrorsInOverlay
  }
})
//webpack的配置，可以理解成是开发环境和正式环境的一些公共配置
module.exports = {
  //webpack 解析时根目录地址如果此文件在跟目录这句话就不用写
  context: path.resolve(__dirname, '../'),
  entry: {
    //入口文件是src目录下的main.js
    app: './src/main.js'
  },
  output: {
    //路径是config目录下的index.js中的build配置中的assetsRoot,也就是dist目录
    path: config.build.assetsRoot,
    //文件名称这里使用默认的name也就是main
    filename: '[name].js',
    //上线地址，也就是真正的文件引用路径，如果是production生产环境，其实这里都是'/'
    publicPath: process.env.NODE_ENV === 'production'
      ? config.build.assetsPublicPath
      : config.dev.assetsPublicPath
  },
  resolve: {
     // resolve是webpack的内置选项，顾名思义，决定要做的事情，也就是说当使用 import "jquery"，该如何去执行这件事
    // 情就是resolve配置项要做的，import jQuery from "./additional/dist/js/jquery" 这样会很麻烦，可以起个别名简化操作
    extensions: ['.js', '.vue', '.json'],// 省略扩展名，也就是说.js,.vue,.json文件导入可以省略后缀名，这会覆盖默认的配置，所以要省略扩展名在这里一定要写上
    alias: {
        //后面的$符号指精确匹配，也就是说只能使用 import vuejs from "vue" 这样的方式导入vue.esm.js文件，不能在后面跟上 vue/vue.js
      'vue$': 'vue/dist/vue.esm.js',
      // resolve('src') 其实在这里就是项目根目录中的src目录，使用 import somejs from "@/some.js" 就可以导入指定文件，是不是很高大上
      '@': resolve('src'),
    }
  },
  // module用来解析不同的模块
  module: {
    //转换解析规则
        //1.test是用来解析所有此后缀名的文件，
        //2.loader我们用什么npm什么形式的loader去解析
        //3.include是代表我们解析的文件只包含那些东西
        //4.options解析文件参数设置 具体看下面的解释
    rules: [
      ...(config.dev.useEslint ? [createLintingRule()] : []),
      {
        test: /.vue$/,
        // 对vue文件使用vue-loader，该loader是vue单文件组件的实现核心，专门用来解析.vue文件的
        loader: 'vue-loader',
        // 将vueLoaderConfig当做参数传递给vue-loader,就可以解析文件中的css相关文件
        options: vueLoaderConfig
      },
      {
        test: /.js$/,
         // 对js文件使用babel-loader转码,该插件是用来解析es6等代码
        loader: 'babel-loader',
        // 指明src和test目录下的js文件要使用该loader
        include: [resolve('src'), resolve('test'), resolve('node_modules/webpack-dev-server/client')]
      },
      {
        test: /.(png|jpe?g|gif|svg)(?.*)?$/,
          // 对图片相关的文件使用 url-loader 插件，这个插件的作用是将一个足够小的文件生成一个64位的DataURL
        // 可能有些老铁还不知道 DataURL 是啥，当一个图片足够小，为了避免单独请求可以把图片的二进制代码变成64位的
        // DataURL，使用src加载，也就是把图片当成一串代码，避免请求，神不神奇？？
        loader: 'url-loader',
        options: {
          // 限制 10000 个字节一下的图片才使用DataURL
          limit: 10000,
          name: utils.assetsPath('img/[name].[hash:7].[ext]')// 这个函数执行结果是 /img/[name].[hash:7].[ext]
           // 不知道吧 name 设置成 /img/[name].[hash:7].[ext] 意欲何为，猜测应该是输出图片的路径或者是解析图片的路径
        }
      },
      {
         //对一些音频文件进行解析
        test: /.(mp4|webm|ogg|mp3|wav|flac|aac)(?.*)?$/,
        loader: 'url-loader',
        options: {
          limit: 10000,
          name: utils.assetsPath('media/[name].[hash:7].[ext]')
        }
      },
      {
        //对字体文件进行解析
        test: /.(woff2?|eot|ttf|otf)(?.*)?$/,
        loader: 'url-loader',
        options: {
          limit: 10000,
          name: utils.assetsPath('fonts/[name].[hash:7].[ext]')
        }
      }
    ]
  },
  node: {
    // 是否 polyfill 或 mock
        // prevent webpack from injecting useless setImmediate polyfill because Vue
        // 源包含它（虽然仅在本地使用)
    // source contains it (although only uses it if it's native).
    setImmediate: false,
    // 预防webpack从注入模拟节点到node原生模块
    // prevent webpack from injecting mocks to Node native modules
     // that does not make sense for the client 这对客户端没有影响
    // that does not make sense for the client
    dgram: 'empty',
    fs: 'empty',
    net: 'empty',
    tls: 'empty',
    child_process: 'empty'
  }
}