Vue CLI 3的Vue.config.js

module.exports = {
  // 部署应用包时的基本URL。 
  // https://www.app.com/ => '/'
  // https://www.app.com/my-app/ => '/my-app/'
  // 如果值为空字符串 '' 或者是相对路径 './', 都会被链接为相对路径
  baseUrl: process.env.NODE_ENV === 'production' ? '/' : '/',
  // 生成环境构建文件的目录。构建时传入 --no-clean 可关闭该行为
  outputDir: 'dist',
  // 放置生成的静态资源(js, css, img, fonts)d的(相对于 outputDir 的)目录
  assetsDir: '',
  // 指定生成的 index.html 的输出路径 (相对于 outputDir ).也可以是一个绝对路径
  indexPath: 'index.html',
  // 生成的静态资源在它们的文件名中包含了hash以便更好的控制缓存。
  // 如果你无法使用Vue CLI生成的 index THML,你可以通过将这个选项设为 false 来关闭文件名哈希
  filenameHashing: true,
  pages: {
    index: {
      // 页面入口
      entry: 'src/main.js',
      // 模板来源
      template: 'public/index.html',
      // 在 dist/index.html 的输出
      filename: 'index.html',
      // 当使用 title 选项时,
      // template 中的 title 标签需要是 <title><%= htmlWebpackPlugin.options.title %></title>
      title: 'hello-world',
      // 在这个页面中包含的块,默认情况下会包含提取出来的通用 chunk 和 vendor chunk
      chunks: [ 'chunk-vendors', 'chunk-common', 'index']
    },
    // 当使用只有入口的字符串格式时,
    // 模板会被推导为 `public/subpage.html`
    // 并且如果找不到的话,就回退到 `public/index.html`
    // 输出文件名会被推导为 `subpage.html`
    subpage: 'src/main.js'
  },
  // 在生成构建时禁用 eslint-loader
  lintOnSave: process.env.NODE_ENV !== 'production',
  // 是否使用包含运行时编译器的Vue构建版本, 
  // 设置为 true 后你就可以在 Vue 组件中使用 template 选项了,但是这会让你的应用额外增加 10kb 左右
  runtimeCompiler: false,
  // 默认情况下 babel-loader 会忽略所有 node_modules 中的文件。如果你想要通过 Babel 显式转译一个依赖,可以在这个选项中列出来
  transpileDependencies: [],
  // 如果你不需要生产环境的 source map, 可以将其设置为 false 以加速生产环境构建
  productionSourceMap: true,
  // 设置生产的 HTML 中 <link rel="stylesheet"> 和 <script> 标签的 crossorigin 属性
  // 需要注意的是该选项仅影响由 html-webpack-plugin 在构建时注入的标签 - 直接写在模板 (public/index.html) 中的标签不受影响
  crossorigin: undefined,
  integrity: false,
  // 值如果是一个对象,则会通过 webpack-merge 合并到最终的配置中
  // 值如果是一个函数,则会接收被解析的配置作为参数。
  // 该函数及可以修改配置并不返回任何东西,也可以返回一个被克隆或合并过的配置版本。
  // configureWebpack: {
  //   plugins: [
  //     new MyAwesomeWebpackPlugin()
  //   ]
  // },
  configureWebpack: config => {
    if (production.env.NODE_ENV === 'production') {
      // 为生产环境修改配置...
    } else {
      // 为开发环境修改配置...
    }
  },
  // 链式操作 Vue CLI内部的 webpack 配置是通过 webpack-chain 维护的。
  // 这个库提供了一个 webpack 原始配置的上层抽象,使其可以定义具名的 loader 规则和具名插件,并有机会在后期进入这些规则并对它们的选项进行修改
  chainWebpack: config => {
    config.module
      .rule('vue')
      .use('vue-loader')
        .loader('vue-loader')
        .tap(options => {
          // 修改它的选项
          return options
        })
  },
  // 如果想在 js 中作为 CSS Modules 导入 CSS 或其他预处理文件,该文件应该以 *.module.(css|less|sass|scss|styl) 结尾
  // import styles from './foo.module.css'
  // import sassStyles from './foo.module.scss'
  //  如果你想去掉文件名的 .module, 可以设置 vue.config.js 中的 css.modules 为 true
  css: {
    module: true,
    // 提取 CSS 在开发环境模式下是默认不开启的,因为它和 CSS 热重载不兼容。
    // 然而,你仍然可以将这个值显性地设置为 true 在所有情况下都强制提取
    expert: production.env.NODE_ENV === 'production' ? true : false,
    // 是否为 CSS 开启 source map。设置为 true 之后可能会影响构建的性能
    sourceMap: false,
    // 向 CSS 相关的 loader 传递选项
    loaderOptions: {
      css: {
        // 这里的选项会传递给 css-loader
      },
      postcss: {
        // 这里的选项会传递给 postcss-loader
      },
      sass: {
        // 所以这个假设你有 `src/variables.scss`
        // data: `@import "@/variables.scss";`
      }
    }
  },
  devServer: {
    // 在设置让浏览器 overlay 同时显示警告和错误
    overlay: {
      warnings: true,
      errors: true
    },
    proxy: {
      // '/api': {
      //   target: '<url>',
      //   ws: true,
      //   changeOrigin: true
      // },
      // '/foo': {
      //   target: '<other_url>'
      // }
    }
  },
  // 是否为 Babel 或 TypeScript 使用 threa-loader。
  // 该选项在系统的 CPU 有多于一个内核时自动启用,仅作用于生产构建
  parallel: require('os').cpus().length > 1,
  pwa: {
    // 'GenerateSW'(默认), 每次重建 web 应用程序时都会生成一个新的服务工作文件。
    // 'InjectManifest' 允许您从现有的服务工作文件开始,并创建该文件的副本,
    // 并在其中注入 "预先缓存清单"
    workboxPluginMode: 'GenerateSW',
    // workboxOptions:{
    //  swSrc: 'dev/sw.js'
    // }
    // 默认值:"名称"字段 package.json 
    // 用作 apple-mobile-web-app-title 生成的 HTML 中元标记的值。请注意,您需要进行编辑 public/manifest.json 才能与之匹配
    // name: '',
    themeColor: '#4DBA87',
    msTileColor: '#000000',
    appleMobileWebAppCapable: 'no',
    appleMobileWebAppStatusBarStyle: 'default',
    // 如果您需要根据浏览器的缓存想 NOT 和 manifest 添加版本,则使用此选项。
    // 这将附加 ?v=<pwa.assetsVersion> 到图标和清单的 URL 。
    assetsVersion: '',
    // 应用程序清单的路径
    manifestPath: 'manifest.json',
    iconPaths: {
      favicon32: 'img/icons/favicon-32x32.png',
      favicon16: 'img/icons/favicon-16x16.png',
      appleTouchIcon: 'img/icons/apple-touch-icon-152x152.png',
      maskIcon: 'img/icons/safari-pinned-tab.svg',
      msTileImage: 'img/icons/msapplication-icon-144x144.png',
    },
  },
  // 这是一个不进行任何 schema(模式) 验证的对象,因此它可以用来传递任何第三方插件选项。
  pluginOptions: {
    foo: {
      // 插件可以作为 `options.pluginOptions.foo` 访问这些选项
    }
  }
}

 具体的可以去查看官网

posted @ 2018-10-16 17:46  Tsingtree  阅读(3209)  评论(0编辑  收藏  举报