vue.config.js 配置項解釋

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

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

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