vue.config.js 配置項(xiàng)解釋

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

module.exports = {
  // 部署應(yīng)用時(shí)的基本 URL
  // 如果應(yīng)用被部署在一個(gè)子路徑上，你就需要用這個(gè)選項(xiàng)指定這個(gè)子路徑。
  // 例如，如果你的應(yīng)用被部署在 https://www.my-app.com/my-app/，則設(shè)置 publicPath 為 /my-app/
  publicPath: process.env.NODE_ENV === 'production' ? '/production/' : '/',
  // build時(shí)構(gòu)建文件的目錄 構(gòu)建時(shí)傳入 --no-clean 可關(guān)閉該行為
  outputDir: '/dist',
  // build時(shí)放置生成的靜態(tài)資源 (js、css、img、fonts) 的 (相對(duì)于 outputDir 的) 目錄
  assetsDir: '/static',
  // 指定生成的 index.html 的輸出路徑 (相對(duì)于 outputDir)。也可以是一個(gè)絕對(duì)路徑。
  indexPath: '/',
  // 默認(rèn)在生成的靜態(tài)資源文件名中包含 hash 以便更好的控制緩存。
  filenameHashing: false,
  // "多頁面"模式下。每個(gè)“page”應(yīng)該有一個(gè)對(duì)應(yīng)的 JavaScript 入口文件。其值應(yīng)該是一個(gè)對(duì)象，對(duì)象的 key 是入口的名字，
  // value 是：一個(gè)指定了 entry, template, filename, title 和 chunks 的對(duì)象 (除了 entry 之外都是可選的)；或一個(gè)指定其 entry 的字符串。
  pages: {
    index: {
      entry: '/src/main.js', // page 的入口
      template: '/index.html', // 模板文件來源
      filename: 'index.html', // 在 dist/index.html 的輸出
      title: '主頁 Index Page', // 當(dāng)使用 title 選項(xiàng)時(shí)，template 中的 title 標(biāo)簽需要是 <title><%= htmlWebpackPlugin.options.title %></title>
      chunks: ['chunk-vendors', 'chunk-common', 'index'], // 在這個(gè)頁面中包含的塊，默認(rèn)情況下會(huì)包含, 提取出來的通用 chunk 和 vendor chunk。
    },
    // 當(dāng)使用只有入口的字符串格式時(shí)，
    // 模板會(huì)被推導(dǎo)為 `public/subpage.html`
    // 并且如果找不到的話，就回退到 `public/index.html`。
    // 輸出文件名會(huì)被推導(dǎo)為 `subpage.html`。
    subpage: 'src/pages/main.js',
  },
  // 是否在保存的時(shí)候使用 `eslint-loader` 進(jìn)行檢查。
  // 是否在開發(fā)環(huán)境下通過 eslint-loader 在每次保存時(shí) lint 代碼 (在生產(chǎn)構(gòu)建時(shí)禁用 eslint-loader)
  lintOnSave: process.env.NODE_ENV !== 'production',
  // 是否使用包含運(yùn)行時(shí)編譯器的 Vue 構(gòu)建版本
  runtimeCompiler: false,
  // 是否為生產(chǎn)環(huán)境構(gòu)建生成 source map？，設(shè)為false打包時(shí)不生成.map文件, 以加速生產(chǎn)環(huán)境構(gòu)建
  productionSourceMap: false,

  // babel-loader 默認(rèn)會(huì)跳過 node_modules 依賴。通過這個(gè)選項(xiàng)可以顯式轉(zhuǎn)譯一個(gè)依賴。
  // Babel 顯式轉(zhuǎn)譯列表
  transpileDependencies: [
    /* string or regex */
  ],
  // 調(diào)整內(nèi)部的 webpack 配置。
  // 查閱 https://cli.vuejs.org/guide/webpack.html#simple-configuration
  // 如果這個(gè)值是一個(gè)對(duì)象，則會(huì)通過 webpack-merge 合并到最終的配置中。
  // 如果這個(gè)值是一個(gè)函數(shù)，則會(huì)接收被解析的配置作為參數(shù)。該函數(shù)既可以修改配置并不返回任何東西，也可以返回一個(gè)被克隆或合并過的配置版本。
  configureWebpack: (config) => {
    config.resolve = {
      // 配置解析別名
      extensions: ['.js', '.json', '.vue'],
      alias: {
        '@': path.resolve(__dirname, './src'),
        components: path.resolve(__dirname, './src/components'),
      },
    }
  },
  // 對(duì)內(nèi)部的 webpack 配置（比如修改、增加Loader選項(xiàng)）(鏈?zhǔn)讲僮?。
  chainWebpack: () => {},
  // CSS 相關(guān)選項(xiàng)
  css: {
    // 當(dāng)為true時(shí)，css文件名可省略 module 默認(rèn)為 false
    modules: true,
    // 是否將組件中的 CSS 提取至一個(gè)獨(dú)立的 CSS 文件中,當(dāng)作為一個(gè)庫構(gòu)建時(shí)，你也可以將其設(shè)置為 false 免得用戶自己導(dǎo)入 CSS
    // 默認(rèn)生產(chǎn)環(huán)境下是 true，開發(fā)環(huán)境下是 false
    extract: false,
    // 是否為 CSS 開啟 source map。設(shè)置為 true 之后可能會(huì)影響構(gòu)建的性能
    sourceMap: false,
    //向 CSS 相關(guān)的 loader 傳遞選項(xiàng)(支持 css-loader postcss-loader sass-loader less-loader stylus-loader)
    loaderOptions: {},
  },
  // 配置 webpack-dev-server 行為。
  devServer: {
    port: 6000,
    host: '0.0.0.0',
  },
  // 傳遞給 PWA 插件的選項(xiàng)。
  // 查閱 https://github.com/vuejs/vue-cli/tree/dev/packages/@vue/cli-plugin-pwa
  pwa: {},
  // 在生產(chǎn)環(huán)境下為 Babel 和 TypeScript 使用 `thread-loader`
  // 在多核機(jī)器下會(huì)默認(rèn)開啟。
  parallel: require('os').cpus().length > 1,
  // 三方插件的選項(xiàng)
  pluginOptions: {
    // ...
  },
}