vue-cli2.0配置文件详解 --齐枭飞前端

webpack.base.conf.js
配有一些基础要素包括，会和 通常的webapck.config.js类似。

// 0. 引入一些依赖
var path = require('path')
var utils = require('./utils')
var config = require('../config')
var vueLoaderConfig = require('./vue-loader.conf')

function resolve (dir) {
  return path.join(__dirname, '..', dir)
}

module.exports = {
  entry: {                  // 1. 入口文件配置
    app: './src/main.js'
  },
  output: {                 // 2. 输出文件配置
    path: config.build.assetsRoot,    // 输出目录的绝对路径
    filename: '[name].js',            // 输出的文件的名称，name为对应entry的key
    publicPath: process.env.NODE_ENV === 'production'   // 生产模式或开发模式下html、js等文件内部引用的公共路径(请求的静态资源绝对路径)
      ? config.build.assetsPublicPath  
      : config.dev.assetsPublicPath
  },                        
  resolve: {                // 3. 文件解析配置，设置模块如何被解析
    // 在代码中通过require/import模块的相关配置，预定义了.js 和.vue的扩展，这样在引用一个hello.js文件时，我们只需要import Hello from '/path/to/directory/hello'就能够做到
    extensions: ['.js', '.vue', '.json'],   // 自动解析确定的拓展名,使导入模块时不带拓展名，即在require/import模块路径中自动补全文件后缀
    alias: {                                // 路径的别名，require/import模块路径中可以通过别名缩短路径字符串的长度，节省了大量时间去计算文件与文件之间的嵌套关系
      'vue$': 'vue/dist/vue.esm.js',
      '@': resolve('src'),
    }
  },
  module: {                 // 4. 模块解析配置，如何处理项目不同类型的模块
    rules: [
      {
        test: /\.(js|vue)$/,      // 代码文件后缀
        loader: 'eslint-loader',
        enforce: "pre",
        include: [resolve('src'), resolve('test')],
        options: {
          formatter: require('eslint-friendly-formatter')
        }
      },
      {
        test: /\.vue$/,           // vue文件后缀
        loader: 'vue-loader',
        options: vueLoaderConfig
      },
      {
        test: /\.js$/,            // js文件后缀
        loader: 'babel-loader',
        include: [resolve('src'), resolve('test')]
      },
      {
        test: /\.(png|jpe?g|gif|svg)(\?.*)?$/,        // 图片文件后缀
        loader: 'url-loader',
        query: {
          limit: 10000, // 当图片大小小于10kb时，会生成一个base64串打包到编译后的js文件里，若超过10kb会单独生成一个文件
          name: utils.assetsPath('img/[name].[hash:7].[ext]')
        }
      },
      {
        test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/,       // 字体文件后缀
        loader: 'url-loader',
        query: {
          limit: 10000,
          name: utils.assetsPath('fonts/[name].[hash:7].[ext]')
        }
      }
    ]
  }
}

webpack.dev.conf.js
这个配置将针对我们本机开发时使用。

var utils = require('./utils')          // 工具方法
var webpack = require('webpack')
var config = require('../config')
var merge = require('webpack-merge')    // 合并配置文件
var baseWebpackConfig = require('./webpack.base.conf') // 开发时和运行时共享的的webpack配置文件
var HtmlWebpackPlugin = require('html-webpack-plugin') // 操作html文件的插件
var FriendlyErrorsPlugin = require('friendly-errors-webpack-plugin')

Object.keys(baseWebpackConfig.entry).forEach(function (name) {    // 启用热加载       
  baseWebpackConfig.entry[name] = ['./build/dev-client'].concat(baseWebpackConfig.entry[name])
})

module.exports = merge(baseWebpackConfig, {
  module: {   //通过传入一些配置来获取rules配置，此处传入了sourceMap: false,表示不生成sourceMap
    rules: utils.styleLoaders({ sourceMap: config.dev.cssSourceMap })
  },
  devtool: '#cheap-module-eval-source-map',         // 指定sourceMap类型 方便源码定位
  plugins: [                                        // 一些额外的插件，不是必须的
    new webpack.DefinePlugin({                  // 编译时配置的全局变量
      'process.env': config.dev.env   //当前环境为开发环境
    }),
    new webpack.HotModuleReplacementPlugin(),   // 热更新插件
    new webpack.NoEmitOnErrorsPlugin(),         // 不触发错误,即编译后运行的包正常运行，编译出错时跳过那部分代码
    new HtmlWebpackPlugin({                     // 以现有html为模板去生成新的html以及相应配置，比如编译后文件的引入
      filename: 'index.html', //生成的文件名
      template: 'index.html', //模板
      inject: true            // 表示css、js路径自动添加到该html文件里（css->header标签,js->body），也可配置
    }),
    new FriendlyErrorsPlugin()                  // 友好的错误提示
  ]
})

webpack.prod.conf.js
生产环境下的webpack配置，通过merge方法合并webpack.base.conf.js基础配置，这个文件将定义打包好的生成文件。

var path = require('path')
var utils = require('./utils')
var webpack = require('webpack')
var config = require('../config')
var merge = require('webpack-merge')
var baseWebpackConfig = require('./webpack.base.conf')
var CopyWebpackPlugin = require('copy-webpack-plugin')
var HtmlWebpackPlugin = require('html-webpack-plugin')
var ExtractTextPlugin = require('extract-text-webpack-plugin')          // 针对 vue文件里的样式单独拆分，这样他们会被合并到css文件里去
var OptimizeCSSPlugin = require('optimize-css-assets-webpack-plugin')

var env = config.build.env

var webpackConfig = merge(baseWebpackConfig, {
  module: {
    rules: utils.styleLoaders({
      sourceMap: config.build.productionSourceMap,
      extract: true
    })
  },
  devtool: config.build.productionSourceMap ? '#source-map' : false,
  output: {
    path: config.build.assetsRoot,
    filename: utils.assetsPath('js/[name].[chunkhash].js'),
    chunkFilename: utils.assetsPath('js/[id].[chunkhash].js')
  },
  plugins: [
    new webpack.DefinePlugin({
      'process.env': env
    }),
    new webpack.optimize.UglifyJsPlugin({
      compress: {
        warnings: false
      },
      sourceMap: true
    }),
    // extract css into its own file
    new ExtractTextPlugin({
      filename: utils.assetsPath('css/[name].[contenthash].css')
    }),
    // Compress extracted CSS. We are using this plugin so that possible
    // duplicated CSS from different components can be deduped.
    new OptimizeCSSPlugin({
      cssProcessorOptions: {
        safe: true
      }
    }),
    // generate dist index.html with correct asset hash for caching.
    // you can customize output by editing /index.html
    // see https://github.com/ampedandwired/html-webpack-plugin
    new HtmlWebpackPlugin({
      filename: config.build.index,
      template: 'index.html',
      inject: true,
      minify: {
        removeComments: true,
        collapseWhitespace: true,
        removeAttributeQuotes: true
      },
      chunksSortMode: 'dependency'
    }),
    // split vendor js into its own file
    new webpack.optimize.CommonsChunkPlugin({
      name: 'vendor',
      minChunks: function (module, count) {
        return (
          module.resource &&
          /\.js$/.test(module.resource) &&
          module.resource.indexOf(
            path.join(__dirname, '../node_modules')
          ) === 0
        )
      }
    }),
    // extract webpack runtime and module manifest to its own file in order to
    // prevent vendor hash from being updated whenever app bundle is updated
    new webpack.optimize.CommonsChunkPlugin({
      name: 'manifest',
      chunks: ['vendor']
    }),
    // copy custom static assets
    new CopyWebpackPlugin([
      {
        from: path.resolve(__dirname, '../static'),
        to: config.build.assetsSubDirectory,
        ignore: ['.*']
      }
    ])
  ]
})

if (config.build.productionGzip) {
  var CompressionWebpackPlugin = require('compression-webpack-plugin')

  webpackConfig.plugins.push(
    new CompressionWebpackPlugin({
      asset: '[path].gz[query]',
      algorithm: 'gzip',
      test: new RegExp(
        '\\.(' +
        config.build.productionGzipExtensions.join('|') +
        ')$'
      ),
      threshold: 10240,
      minRatio: 0.8
    })
  )
}

if (config.build.bundleAnalyzerReport) {
  var BundleAnalyzerPlugin = require('webpack-bundle-analyzer').BundleAnalyzerPlugin
  webpackConfig.plugins.push(new BundleAnalyzerPlugin())
}

module.exports = webpackConfig