VueCli 3.0 配置 vue.config 优化完整版
目录
一、基础配置
二、服务和跨域代理设置
三、CSS相关设置
四、chainWebpack配置
五、chainWebpack配置
六、完整版vue.config.js
一、基础配置
module.exports = {
runtimeCompiler: true, // Default: false 是否使用包含运行时编译器的 Vue 构建版本。设置为 true 后你就可以在 Vue 组件中使用 template 选项了，但是这会让你的应用额外增加 10kb 左右。
publicPath: './', // 根路径 cli3.0以上使用publicPath替代baseUrzl,解决build后找不到静态资源的问题
productionSourceMap: false, // 如果你不需要生产环境的 source map，可以将其设置为 false 以加速生产环境构建。
lintOnSave: false, // process.env.NODE_ENV === 'development',//是否开启eslint保存检测 ,它的有效值为 true || false || 'error'
outputDir: process.env.NODE_ENV === 'production' ? 'build' : 'devbuild', // 打包环境-文件输出的目录名
productionSourceMap: false, // 是否产生map
}二、服务和跨域代理设置
devServer: { // 服务端设置
port: 8080, // 端口
open: false, // 启动项目后自动开启浏览器
overlay: { // 设置让浏览器 overlay 同时显示警告和错误
warnings: false,
errors: false
},
// 请求代理
proxy: {
'/api': {
target: 'http://0.0.0.0:8085', // 代理地址，这里设置的地址会代替axios中设置的baseURL
ws: false, // proxy websockets
changeOrigin: true, // 如果接口跨域，需要进行这个参数配置
pathRewrite: {
'/api': ''
}
},
}
},三、CSS相关设置
// css相关配置
css: {
extract: false, // 是否使用css分离插件 ExtractTextPlugin (默认生产为true，开发为false)
sourceMap: false, // 开启 CSS source maps?
loaderOptions: {
css: {}, // 这里的选项会传递给 css-loader
}, // css预设器配置项
modules: false // 启用 CSS modules for all css / pre-processor files.
},四、chainWebpack配置
如果这个值是一个对象，则会通过 webpack-merge 合并到最终的配置中。
如果这个值是一个函数，则会接收被解析的配置作为参数。该函数既可以修改配置并不返回任何东西，也可以返回一个被克隆或合并过的配置版本。
更多细节可查阅：配合 webpack > 简单的配置方式
因为用到了UglifyJsPlugin插件移除线上环境的console.log， 所以需要去yarn add uglifyjs-webpack-plugin 或者 npm install uglifyjs-webpack-plugin --save 安装该插件
/** 引入uglifyjs-webpack-plugin */
const UglifyJsPlugin = require('uglifyjs-webpack-plugin');// 基于环境有条件地配置行为
configureWebpack: config => {
// 线上版本
if (process.env.NODE_ENV === 'production') {
// 为生产环境修改配置
config.mode = 'production';
/** 移除console */
config.optimization.minimizer.push(
new UglifyJsPlugin({
uglifyOptions: {
warnings: false,
compress: {
drop_console: true,
drop_debugger: true,
pure_funcs: ['console.log']
}
}
})
)
} else {
// 为开发环境修改配置
config.mode = 'development'
}
Object.assign(config, {
// 开发生产共同配置
resolve: {
extensions: ['.js', '.vue', '.json'], // 引入时可省略扩展名
alias: { // 自定义别名
'@': path.resolve(__dirname, './src')
}
}
})
},五、chainWebpack配置
-
一个函数，会接收一个基于 webpack-chain 的
ChainableConfig实例。允许对内部的 webpack 配置进行更细粒度的修改。更多细节可查阅：配合 webpack > 链式操作
1. mini-css-extract-plugin
用到了 mini-css-extract-plugin 抽离css支持按需加载，所以需要安装该插件
2. compression-webpack-plugin
用到了 compression-webpack-plugin 进行开启gzip压缩，需要安装该插件
要使服务器返回.gz文件，还需要对服务器进行配置，根据Request Headers的Accept-Encoding标签进行鉴别，如果支持gzip就返回.gz文件
3. image-webpack-loader
图片压缩，需要安装 image-webpack-loader 插件
/** 引入mini-css-extract-plugin */
const MiniCssExtractPlugin = require('mini-css-extract-plugin');
// resolve辅助函数
function resolve (dir) {
return path.join(__dirname, dir)
}
// 全局编译公共样式方案
function addStyleResource (rule) {
rule.use('style-resource')
.loader('style-resources-loader')
.options({
patterns: [
path.resolve(__dirname, 'src/stylus/imports.styl'),
],
})
}// 对webpack内部配置进行颗粒度的修改
chainWebpack: config => {
// 修复HRM
config.resolve.symlinks(true)
// 打包代码分割
config.optimization.splitChunks({
chunks: "all", //async异步代码分割 initial同步代码分割 all同步异步分割都开启
minSize: 30000, //字节 引入的文件大于30kb才进行分割
//maxSize: 50000, //50kb，尝试将大于50kb的文件拆分成n个50kb的文件
minChunks: 1, //模块至少使用次数
maxAsyncRequests: 5, //同时加载的模块数量最多是5个，只分割出同时引入的前5个文件
maxInitialRequests: 3, //首页加载的时候引入的文件最多3个
automaticNameDelimiter: '~', //缓存组和生成文件名称之间的连接符
name: true, //缓存组里面的filename生效，覆盖默认命名
cacheGroups: { //缓存组，将所有加载模块放在缓存里面一起分割打包
default: { //默认打包模块
priority: -20,
reuseExistingChunk: true, //模块嵌套引入时，判断是否复用已经被打包的模块
filename: 'common.js'
},
elementUi: {
name: 'chunk-elementUi',
test: /[\\/]node_modules[\\/]_?element-ui(.*)/,
priority: 20
}
}
})
// 抽离css支持按需加载
let miniCssExtractPlugin = new MiniCssExtractPlugin({
filename: 'assets/[name].[hash:8].css',
chunkFilename: 'assets/[name].[hash:8].css'
})
config.plugin('extract-css').use(miniCssExtractPlugin)
// 移除 preload 插件 （去除默认预加载）
config.plugins.delete('preload')
// 移除 prefetch 插件 （去除默认预加载）
config.plugins.delete('prefetch')
// 全局引入stylus方法
const types = ['vue-modules', 'vue', 'normal-modules', 'normal']
types.forEach(type => addStyleResource(config.module.rule('stylus').oneOf(type)))
// 配置svg规则排除icons目录中svg文件处理
config.module
.rule('icons')
.test(/\.svg$/)
.include.add(resolve('src/icons'))
.end()
.use('svg-sprite-loader')
.loader('svg-sprite-loader')
.options({
symbolId: 'icon-[name]'
})
// 配置vue规则
config.module
.rule('vue')
.use('vue-loader')
.loader('vue-loader')
.tap(options => {
// 修改它的选项
return options
})
// 开启gzip压缩
if (config.productionGzip) {
const CompressionWebpackPlugin = require('compression-webpack-plugin')
// 增加浏览器CPU（需要解压缩）， 减少网络传输量和带宽消耗 （需要衡量，一般小文件不需要压缩的）
// 图片和PDF文件不应该被压缩，因为他们已经是压缩的了，试着压缩他们会浪费CPU资源而且可能潜在增加文件大小。
config.plugins.push(
new CompressionWebpackPlugin({
asset: '[path].gz[query]',
algorithm: 'gzip',
test: /\.(js|css)$/,
threshold: 10240, // 达到10kb的静态文件进行压缩 按字节计算
minRatio: 0.8, // 只有压缩率比这个值小的资源才会被处理
deleteOriginalAssets: false // 使用删除压缩的源文件
})
)
}
//压缩图片
config.module
.rule('images')
.test(/\.(png|jpe?g|gif|svg)(\?.*)?$/)
.use('image-webpack-loader')
.loader('image-webpack-loader')
.options({
bypassOnDebug: true
})
.end()
}六、完整版vue.config.js
const path = require('path')
/** 引入uglifyjs-webpack-plugin */
const UglifyJsPlugin = require('uglifyjs-webpack-plugin');
/** 引入mini-css-extract-plugin */
const MiniCssExtractPlugin = require('mini-css-extract-plugin');
// resolve辅助函数
function resolve (dir) {
return path.join(__dirname, dir)
}
// 全局编译公共样式方案
function addStyleResource (rule) {
rule.use('style-resource')
.loader('style-resources-loader')
.options({
patterns: [
path.resolve(__dirname, 'src/stylus/imports.styl'),
],
})
}
module.exports = {
runtimeCompiler: true, // Default: false 是否使用包含运行时编译器的 Vue 构建版本。设置为 true 后你就可以在 Vue 组件中使用 template 选项了，但是这会让你的应用额外增加 10kb 左右。
publicPath: './', // 根路径 cli3.0以上使用publicPath替代baseUrzl,解决build后找不到静态资源的问题
productionSourceMap: false, // 如果你不需要生产环境的 source map，可以将其设置为 false 以加速生产环境构建。
lintOnSave: false, // process.env.NODE_ENV === 'development',//是否开启eslint保存检测 ,它的有效值为 true || false || 'error'
outputDir: process.env.NODE_ENV === 'production' ? 'build' : 'devbuild', // 打包环境-文件输出的目录名
productionSourceMap: false, // 是否产生map
devServer: { // 服务端设置
port: 8080, // 端口
open: false, // 启动项目后自动开启浏览器
overlay: { // 设置让浏览器 overlay 同时显示警告和错误
warnings: false,
errors: false
},
// 请求代理
proxy: {
'/api': {
target: 'http://0.0.0.0:8085', // 代理地址，这里设置的地址会代替axios中设置的baseURL
ws: false, // proxy websockets
changeOrigin: true, // 如果接口跨域，需要进行这个参数配置
pathRewrite: {
'/api': ''
}
},
}
},
// 基于环境有条件地配置行为
configureWebpack: config => {
// 线上版本
if (process.env.NODE_ENV === 'production') {
// 为生产环境修改配置
config.mode = 'production';
/** 移除console */
config.optimization.minimizer.push(
new UglifyJsPlugin({
uglifyOptions: {
warnings: false,
compress: {
drop_console: true,
drop_debugger: true,
pure_funcs: ['console.log']
}
}
})
)
} else {
// 为开发环境修改配置
config.mode = 'development'
}
Object.assign(config, {
// 开发生产共同配置
resolve: {
extensions: ['.js', '.vue', '.json'], // 引入时可省略扩展名
alias: { // 自定义别名
'@': path.resolve(__dirname, './src')
}
}
})
},
// css相关配置
css: {
extract: false, // 是否使用css分离插件 ExtractTextPlugin (默认生产为true，开发为false)
sourceMap: false, // 开启 CSS source maps?
loaderOptions: {
css: {}, // 这里的选项会传递给 css-loader
}, // css预设器配置项
modules: false // 启用 CSS modules for all css / pre-processor files.
},
// 对webpack内部配置进行颗粒度的修改
chainWebpack: config => {
// 修复HRM
config.resolve.symlinks(true)
// 打包代码分割
config.optimization.splitChunks({
chunks: "all", //async异步代码分割 initial同步代码分割 all同步异步分割都开启
minSize: 30000, //字节 引入的文件大于30kb才进行分割
//maxSize: 50000, //50kb，尝试将大于50kb的文件拆分成n个50kb的文件
minChunks: 1, //模块至少使用次数
maxAsyncRequests: 5, //同时加载的模块数量最多是5个，只分割出同时引入的前5个文件
maxInitialRequests: 3, //首页加载的时候引入的文件最多3个
automaticNameDelimiter: '~', //缓存组和生成文件名称之间的连接符
name: true, //缓存组里面的filename生效，覆盖默认命名
cacheGroups: { //缓存组，将所有加载模块放在缓存里面一起分割打包
default: { //默认打包模块
priority: -20,
reuseExistingChunk: true, //模块嵌套引入时，判断是否复用已经被打包的模块
filename: 'common.js'
},
elementUi: {
name: 'chunk-elementUi',
test: /[\\/]node_modules[\\/]_?element-ui(.*)/,
priority: 20
}
}
})
// 抽离css支持按需加载
let miniCssExtractPlugin = new MiniCssExtractPlugin({
filename: 'assets/[name].[hash:8].css',
chunkFilename: 'assets/[name].[hash:8].css'
})
config.plugin('extract-css').use(miniCssExtractPlugin)
// 移除 preload 插件 （去除默认预加载）
config.plugins.delete('preload')
// 移除 prefetch 插件 （去除默认预加载）
config.plugins.delete('prefetch')
// 全局引入stylus方法
const types = ['vue-modules', 'vue', 'normal-modules', 'normal']
types.forEach(type => addStyleResource(config.module.rule('stylus').oneOf(type)))
// 配置svg规则排除icons目录中svg文件处理
config.module
.rule('icons')
.test(/\.svg$/)
.include.add(resolve('src/icons'))
.end()
.use('svg-sprite-loader')
.loader('svg-sprite-loader')
.options({
symbolId: 'icon-[name]'
})
// 配置vue规则
config.module
.rule('vue')
.use('vue-loader')
.loader('vue-loader')
.tap(options => {
// 修改它的选项
return options
})
// 开启gzip压缩
if (config.productionGzip) {
const CompressionWebpackPlugin = require('compression-webpack-plugin')
// 增加浏览器CPU（需要解压缩）， 减少网络传输量和带宽消耗 （需要衡量，一般小文件不需要压缩的）
// 图片和PDF文件不应该被压缩，因为他们已经是压缩的了，试着压缩他们会浪费CPU资源而且可能潜在增加文件大小。
config.plugins.push(
new CompressionWebpackPlugin({
asset: '[path].gz[query]',
algorithm: 'gzip',
test: /\.(js|css)$/,
threshold: 10240, // 达到10kb的静态文件进行压缩 按字节计算
minRatio: 0.8, // 只有压缩率比这个值小的资源才会被处理
deleteOriginalAssets: false // 使用删除压缩的源文件
})
)
}
//压缩图片
config.module
.rule('images')
.test(/\.(png|jpe?g|gif|svg)(\?.*)?$/)
.use('image-webpack-loader')
.loader('image-webpack-loader')
.options({
bypassOnDebug: true
})
.end()
}
}
github地址： GitHub - banxia1609/frame: VueCli3.0 + Vue2.0 + element的框架架构