vue-cli3.5之vue.config.js
网上查的一些配置,方便查看,有问题欢迎大家指出,只是一些说明,方便查阅,不要拷贝,会报错!!
module.exports = {
// 部署应用包时的基本URL。
// https://www.app.com/ => '/'
// https://www.app.com/my-app/ => '/my-app/'
// 如果值为空字符串 '' 或者是相对路径 './', 都会被链接为相对路径
//好像被废弃了,使用publicPath 部署应用包时的基本URL。用法和webpack本身的output.publicPath一致。
//但在cli的其它地方也会用到这个值,所以请不要直接修改webpack的output.publicPath
//baseUrl: process.env.NODE_ENV === 'production' ? '/' : '/',
publicPath : '/',
// 生成环境构建文件的目录。构建时传入 --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` 访问这些选项
}
}
}