// see http://vuejs-templates.github.io/webpack for documentation.
// path是node.js的路徑模塊，用來處理路徑統(tǒng)一的問題
var path = require('path')

module.exports = {
 // 下面是build也就是生產(chǎn)編譯環(huán)境下的一些配置
 build: {
  // 導(dǎo)入prod.env.js配置文件，只要用來指定當(dāng)前環(huán)境，詳細(xì)見(1)
  env: require('./prod.env'),
  // 下面是相對路徑的拼接，假如當(dāng)前跟目錄是config，那么下面配置的index屬性的屬性值就是dist/index.html
  index: path.resolve(__dirname, '../dist/index.html'),
  // 下面定義的是靜態(tài)資源的根目錄 也就是dist目錄
  assetsRoot: path.resolve(__dirname, '../dist'),
  // 下面定義的是靜態(tài)資源根目錄的子目錄static，也就是dist目錄下面的static
  assetsSubDirectory: 'static',
  // 下面定義的是靜態(tài)資源的公開路徑，也就是真正的引用路徑
  assetsPublicPath: '/',
  // 下面定義是否生成生產(chǎn)環(huán)境的sourcmap，sourcmap是用來debug編譯后文件的，通過映射到編譯前文件來實(shí)現(xiàn)
  productionSourceMap: true,
  // Gzip off by default as many popular static hosts such as
  // Surge or Netlify already gzip all static assets for you.
  // Before setting to `true`, make sure to:
  // npm install --save-dev compression-webpack-plugin
  // 下面是是否在生產(chǎn)環(huán)境中壓縮代碼，如果要壓縮必須安裝compression-webpack-plugin
  productionGzip: false,
  // 下面定義要壓縮哪些類型的文件
  productionGzipExtensions: ['js', 'css'],
  // Run the build command with an extra argument to
  // View the bundle analyzer report after build finishes:
  // `npm run build --report`
  // Set to `true` or `false` to always turn it on or off
  // 下面是用來開啟編譯完成后的報(bào)告，可以通過設(shè)置值為true和false來開啟或關(guān)閉
  // 下面的process.env.npm_config_report表示定義的一個(gè)npm_config_report環(huán)境變量，可以自行設(shè)置
  bundleAnalyzerReport: process.env.npm_config_report
 },
 dev: {
  // 引入當(dāng)前目錄下的dev.env.js，用來指明開發(fā)環(huán)境，詳見(2)
  env: require('./dev.env'),
  // 下面是dev-server的端口號，可以自行更改
  port: 8080,
  // 下面表示是否自定代開瀏覽器
  autoOpenBrowser: true,
  assetsSubDirectory: 'static',
  assetsPublicPath: '/',
  // 下面是代理表，作用是用來，建一個(gè)虛擬api服務(wù)器用來代理本機(jī)的請求，只能用于開發(fā)模式
  // 詳見(3)
  proxyTable: {},
  // CSS Sourcemaps off by default because relative paths are "buggy"
  // with this option, according to the CSS-Loader README
  // (https://github.com/webpack/css-loader#sourcemaps)
  // In our experience, they generally work as expected,
  // just be aware of this issue when enabling this option.
  // 是否生成css，map文件，上面這段英文就是說使用這個(gè)cssmap可能存在問題，但是按照經(jīng)驗(yàn)，問題不大，可以使用
  // 給人覺得沒必要用這個(gè)，css出了問題，直接控制臺不就完事了
  cssSourceMap: false
 }
}

module.exports = {
  // 作用很明顯，就是導(dǎo)出一個(gè)對象，NODE_ENV是一個(gè)環(huán)境變量，指定production環(huán)境
  NODE_ENV: '"production"'
 }

 // 首先引入的是webpack的merge插件，該插件是用來合并對象，也就是配置文件用的，相同的選項(xiàng)會被覆蓋，至于這里為什么多次一舉，可能另有他圖吧
 var merge = require('webpack-merge')
 // 導(dǎo)入prod.env.js配置文件
 var prodEnv = require('./prod.env')
 // 將兩個(gè)配置對象合并，最終結(jié)果是 NODE_ENV: '"development"'
 module.exports = merge(prodEnv, {
  NODE_ENV: '"development"'
 })

 proxyTable: {
  '/list': {
   target: 'http://api.xxxxxxxx.com', -> 目標(biāo)url地址
   changeOrigin: true, -> 指示是否跨域
   pathRewrite: {
   '^/list': '/list' -> 可以使用 /list 等價(jià)于 api.xxxxxxxx.com/list
   }
  }
 }