# webpack 打包工具（vue）

时间 2019-11-10

标签 webpack 打包工具 vue 繁體版

原文原文链接

vue-webpack 打包工具

个人github iSAM2016
不是教程，是自我总结css

一开始在接触webpack 的时候，简直痛不欲生，如今回头看，作个注释，
固然参考了不少文章。这是一个关于vue 开发的webpack 架构会列举出来
webpack 系列教程
 Webpack——使人困惑的地方
 Express结合Webpack的全栈自动刷新
 Webpack傻瓜式指南（一）
Webpack资源总结html

启动指令vue

"scripts": {
    "dev": "node build/dev-server.js", // 
    "build": "node build/build.js",// 打包
    "lint": "eslint --ext .js,.vue src"
  },

webpack.base.conf.js

webpack基本配置node

var path = require('path')
var config = require('../config')
var utils = require('./utils')
var projectRoot = path.resolve(__dirname, '../')

var env = process.env.NODE_ENV
// check env & config/index.js to decide whether to enable CSS source maps for the
// various preprocessor loaders added to vue-loader at the end of this file
var cssSourceMapDev = (env === 'development' && config.dev.cssSourceMap)
var cssSourceMapProd = (env === 'production' && config.build.productionSourceMap)
var useCssSourceMap = cssSourceMapDev || cssSourceMapProd

// 配置文件的内容须要经过module.exports暴露
module.exports = {

  // 配置须要打包的入口文件，值能够是字符串、数组、对象。
  // 1. 字符串： entry： './entry'
  // 2. 字符串： entry：[ './entry1','entry2'] (多入口)
  // 3. 对象：   entry： {alert/index': path.resolve(pagesDir, `./alert/index/page`)}
  // 多入口书写的形式应为object，由于object,的key在webpack里至关于此入口的name,
  entry: {
    app: './src/main.js'
  },
  output: {

    // 输出文件配置，output 输出有本身的一套规则，经常使用的参数基本就是这三个
    // path: 表示生成文件的根目录 须要一个**绝对路径** path仅仅告诉Webpack结果存储在哪里
    path: config.build.assetsRoot,

    // publicPath 参数表示的是一个URL 路径（指向生成文件的跟目录），用于生成css/js/图片/字体文件
    // 等资源的路径以确保网页能正确地加载到这些资源.
    // “publicPath”项则被许多Webpack的插件用于在生产模式下更新内嵌到css、html文件里的url值.
    // 例如，在localhost（即本地开发模式）里的css文件中边你可能用“./test.png”这样的url来加载图片，
    // 可是在生产模式下“test.png”文件可能会定位到CDN上而且你的Node.js服务器多是运行在HeroKu上边的。
    // 这就意味着在生产环境你必须手动更新全部文件里的url为CDN的路径。
      //开发环境：Server和图片都是在localhost（域名）下
      //.image { 
      // background-image: url('./test.png');
      //}
      // 生产环境：Server部署下HeroKu可是图片在CDN上
      //.image { 
      //  background-image: url('https://someCDN/test.png');
      //}
![](http://images2015.cnblogs.com/blog/1108527/201703/1108527-20170304195944626-432609161.png)


    publicPath: process.env.NODE_ENV === 'production' ? config.build.assetsPublicPath : config.dev.assetsPublicPath,
    
    // filename 属性表示的是如何命名出来的入口文件，规则是一下三种： 
    // [name] 指代入口文件的name，也就是上面提到的entry参数的key，所以，咱们能够在name里利用/，便可达到控制文件目录结构的效果。
    // [hash]，指代本次编译的一个hash版本，值得注意的是，只要是在同一次编译过程当中生成的文件，这个[hash].js 
    //的值就是同样的；在缓存的层面来讲，至关于一次全量的替换。
    filename: '[name].js'
  },

  // 用来配置依赖文件的匹配，如依赖文件的别名配置、模块的查找目录、默认查找的
  // 文件后缀名
  // resolve.root 该选型用来制定模块查找的根路径，必须为**绝对路径**，值能够
  // 是路径字符串或者路径数组如果数组，则会依次查找
  resolve: {
    extensions: ['', '.js', '.vue', '.json'],
    fallback: [path.join(__dirname, '../node_modules')],

    // 用来配置依赖文件的别名，值是一个对，该对象的键是别名，值是实际路径
    alias: {
      'vue$': 'vue/dist/vue.common.js',
      'src': path.resolve(__dirname, '../src'),
      'assets': path.resolve(__dirname, '../src/assets'),
      'components': path.resolve(__dirname, '../src/components')
    }
  },
  resolveLoader: {
    fallback: [path.join(__dirname, '../node_modules')]
  },

  // 用来进行模块加载相关的配置
  module: {
    preLoaders: [
      {
        test: /\.vue$/,
        loader: 'eslint',
        include: projectRoot,
        exclude: /node_modules/
      },
      {
        test: /\.js$/,
        loader: 'eslint',
        include: projectRoot,
        exclude: /node_modules/
      }
    ],
    loaders: [
      // webpack拥有一个相似于插件的机制，名为Loader，经过Loader，webpack可以针对每一种特定的资源作出相应的处理
      // 1.test参数用来指示当前配置项针对哪些资源，该值应是一个条件值(condition)。
      // 2.exclude参数用来剔除掉须要忽略的资源，该值应是一个条件值(condition)。
      // 3.include参数用来表示本loader配置仅针对哪些目录/文件，该值应是一个条件值(condition)。
      // 而include参数则用来指示目录；注意同时使用这二者的时候，其实是and的关系。
      // 4.loader/loaders参数，用来指示用哪一个或哪些loader来处理目标资源，这俩货
      // 表达的实际上是一个意思，只是写法不同，我我的推荐用loader写成一行，多个
      // loader间使用!分割，这种形式相似于管道的概念，又或者说是函数式编程。形
      // 如loader: 'css?!postcss!less'，能够很明显地看出，目标资源先经less-loader
      // 处理事后将结果交给postcss-loader做进一步处理，而后最后再交给css-loader。
      {
        test: /\.vue$/,
        loader: 'vue'
      },
      {
        test: /\.js$/,
        loader: 'babel',
        include: projectRoot,
        exclude: /node_modules/
      },
      {
        test: /\.json$/,
        loader: 'json'
      },
      {
        test: /\.(png|jpe?g|gif|svg)(\?.*)?$/,
        loader: 'url',
        query: {
          limit: 10000,
          name: utils.assetsPath('img/[name].[hash:7].[ext]')
        }
      },
      {
        test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/,
        loader: 'url',
        query: {
          limit: 10000,
          name: utils.assetsPath('fonts/[name].[hash:7].[ext]')
        }
      },
      // expose-loader，这个loader的做用是，将指定js模块export的变量声明为全局变量
      {
        test: require.resolve('jquery'),  // 此loader配置项的目标是NPM中的jquery
        loader: 'expose?$!expose?jQuery', // 先把jQuery对象声明成为全局变量`jQuery`，再经过管道进一步又声明成为全局变量`$`
      },
    ]
  },
  eslint: {
    formatter: require('eslint-friendly-formatter')
  },
  vue: {
    loaders: utils.cssLoaders({ sourceMap: useCssSourceMap }),

    // 解决.vue中文件style的部分一些特性解析，好比scoped
    postcss: [

      require('autoprefixer')({
        browsers: ['last 2 versions']
      })
    ]
  }
}

webpack.dev.conf.js

var config = require('../config')
var webpack = require('webpack')
var merge = require('webpack-merge')
var utils = require('./utils')
var baseWebpackConfig = require('./webpack.base.conf')
var HtmlWebpackPlugin = require('html-webpack-plugin')

// add hot-reload related code to entry chunks
Object.keys(baseWebpackConfig.entry).forEach(function (name) {
  baseWebpackConfig.entry[name] = ['./build/dev-client'].concat(baseWebpackConfig.entry[name])
})

module.exports = merge(baseWebpackConfig, {
  module: {
    loaders: utils.styleLoaders({ sourceMap: config.dev.cssSourceMap })
  },
  // eval-source-map is faster for development
  devtool: '#eval-source-map',
  plugins: [
    // DefinePlugin 是webpack 的内置插件，该插件能够在打包时候替换制定的变量
    // 
    new webpack.DefinePlugin({
      'process.env': config.dev.env
    }),
    // https://github.com/glenjamin/webpack-hot-middleware#installation--usage
    new webpack.optimize.OccurrenceOrderPlugin(),
    new webpack.HotModuleReplacementPlugin(),
    new webpack.NoErrorsPlugin(),
    // https://github.com/ampedandwired/html-webpack-plugin
    new HtmlWebpackPlugin({
      filename: 'index.html',
      template: 'index.html',
      inject: true
    }),
    // 能够自动加载当前模块依赖的其余模块并已制定别名注入到当前的模块中，引入jq
    // 在网上看到的文章，救了个人命 ProvidePlugin + expose-loader 引入jq 
    // 
    // 若是你把jQuery看作是一个普通的js模块来加载（要用到jQuery的模块通通先require
    // 后再使用），那么，当你加载老式jQuery插件时，每每会提示找不到jQuery实例
    // 有时候是提示找不到$），这是为啥呢？
    // 要解释这个问题，就必须先稍微解释一下jQuery插件的机制：jQuery插件是经过
    // jQuery提供的jQuery.fn.extend(object)和jQuery.extend(object)这俩方法，来
    // 把插件自己实现的方法挂载到jQuery（也即$）这个对象上的。传统引用jQuery及
    // 其插件的方式是先用<script>加载jQuery自己，而后再用一样的方法来加载其插件；
    // jQuery会把jQuery对象设置为全局变量（固然也包括了$），既然是全局变量，那么
    // 插件们很容易就能找到jQuery对象并挂载自身的方法了。
    // 
    // 而webpack做为一个听从模块化原则的构建工具，天然是要把各模块的上下文环境给
    // 分隔开以减小相互间的影响；而jQuery也早已适配了AMD/CMD等加载方式，换句话说，
    // 咱们在require jQuery的时候，实际上并不会把jQuery对象设置为全局变量。说到
    // 这里，问题也很明显了，jQuery插件们找不到jQuery对象了，由于在它们各自的上下
    // 文环境里，既没有局部变量jQuery（由于没有适配AMD/CMD，因此就没有相应的requi
    // re语句了），也没有全局变量jQuery。
    // 
    // A: ProvidePlugin的机制是：当webpack加载到某个js模块里，出现了未定义且名称符合
    // （字符串彻底匹配）配置中key的变量时，会自动require配置中value所指定的js模块
    // expose-loader，这个loader的做用是，将指定js模块export的变量声明为全局变量。
    // 
    // B:externals 调用jq 
    // externals是webpack配置中的一项，用来将某个全局变量“假装”成某个js模块的exports，
    // 以下面这个配置：
    // externals: {'jquery': 'window.jQuery',},
    // 那么，当某个js模块显式地调用var $ = require('jquery')的时候，就会把window,
    // jQuery返回给它,与上述ProvidePlugin + expose-loader的方案相反，此方案是先用
    // <script>加载的jQuery知足老式jQuery插件的须要，再经过externals将其转换成符合
    // 模块化要求的exports。
    new webpack.ProvidePlugin({
      $: "jquery",
      jQuery: "jquery",
      "window.jQuery": "jquery",
      'window.$': 'jquery',
    })
  ]
})

webpack.prod.conf.js

var path = require('path')
var config = require('../config')
var utils = require('./utils')
var webpack = require('webpack')
var merge = require('webpack-merge')
var baseWebpackConfig = require('./webpack.base.conf')
var ExtractTextPlugin = require('extract-text-webpack-plugin')
var HtmlWebpackPlugin = require('html-webpack-plugin')
var env = config.build.env

var webpackConfig = merge(baseWebpackConfig, {
  module: {
    loaders: 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')
  },
  vue: {
    loaders: utils.cssLoaders({
      sourceMap: config.build.productionSourceMap,
      extract: true
    })
  },

  // webpack插件位置，有固定的用法
  // 1. 利用Plugin的初始方法并传入Plugin预设的参数进行初始化，生成一个实例。
  // 2. 将此实例插入到webpack配置文件中的plugins参数（数组类型）里便可。
  // 
  // 1. 
  plugins: [
    // http://vuejs.github.io/vue-loader/en/workflow/production.html
    new webpack.DefinePlugin({
      'process.env': env
    }),
    new webpack.optimize.UglifyJsPlugin({
      compress: {
        warnings: false
      }
    }),
    new webpack.optimize.OccurrenceOrderPlugin(),
    // extract css into its own file
    new ExtractTextPlugin(utils.assetsPath('css/[name].[contenthash].css')),
    // 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 生成网页的HTML名字，可使用/来控制文件文件的目录结构，最
      // 终生成的路径是基于webpac配置的output.path的
      filename: config.build.index,
      template: 'index.html',
      inject: true,
      // inject，指示把加载js文件用的<script>插入到哪里，默认是插到<body>
      // 的末端，若是设置为'head'，则把<script>插入到<head>里。
      minify: {
        removeComments: true,
        collapseWhitespace: true,
        removeAttributeQuotes: true
        // more options:
        // https://github.com/kangax/html-minifier#options-quick-reference
      },
      // necessary to consistently work with multiple chunks via CommonsChunkPlugin
      chunksSortMode: 'dependency'
    }),

    // 若是文件是多入口的文件，可能存在，重复代码，把公共代码提取出来，又不会重复下载公共代码了
    // （多个页面间会共享此文件的缓存）
    // CommonsChunkPlugin的初始化经常使用参数有解析？
    // name: 这个给公共代码的chunk惟一的标识
    // filename，如何命名打包后生产的js文件，也是能够用上[name]、[hash]、[chunkhash]
    // minChunks，公共代码的判断标准：某个js模块被多少个chunk加载了才算是公共代码
    new webpack.optimize.CommonsChunkPlugin({
      name: 'vendor',
      minChunks: function (module, count) {
        // any required modules inside node_modules are extracted to vendor
        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']
    })
  ]
})

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
    })
  )
}

module.exports = webpackConfig