:使用 vue-cli 自动构建的项目，没有webpack的设置文件；需要更改webpack 设置可以在vue.config.js中进行修改
configureWebpack：返回一个对象
chainWebpack：函数的链式操作
const ScriptExtHtmlWebpackPlugin = require('script-ext-html-webpack-plugin')
const path = require('path')
function resolve(dir){
return path.join(__dirname,dir)
}
module.exports = {
publicPath: './', // router hash 模式使用
outputDir: 'dist',//输出内容的文件夹
assetsDir: 'static',//编译内容的文件夹
productionSourceMap: false,// 打包时不会生成 .map 文件，加快打包速度
lintOnSave: false ,//关闭格式检查
devServer: { // 开发服务器
host: needHost,
port: port,
open: false,
overlay: {
warnings: false,
errors: true
},
proxy: {
'/api': {
target: 'xxxxxxx',
secure: false,
changeOrigin: true, //是否跨域
logLevel: 'debug',
pathRewrite: {
'^/api': '' // pathRewrite 表示的意思是 把/api 替换为空
}
}
}
},
configureWebpack: {
optimization: {
runtimeChunk: true
},
plugins: [
new ScriptExtHtmlWebpackPlugin({
inline: /runtime~.+\.js$/ //正则匹配runtime文件名
})
]
},
chainWebpack: config => {
// set preserveWhitespace
config.module
.rule('vue')
.use('vue-loader')
.loader('vue-loader')
.tap(options => {
options.compilerOptions.preserveWhitespace = true
return options
}) .end()
config.when(process.env.NODE_ENV === 'development', config => config.devtool('cheap-source-map')) // 设置调试查看源代码
config.optimization.splitChunks({
chunks:'all',
cacheGroups:{
commons:{
name:'chunk-commons',
test:resolve('src/components'),
minChunks:3,
priority:5,
reuseExistingChunk:true
},
libs:{
name:'chunk-libs',
chunks:'initial',
test:/[\\/]node_modules[\\/]/,
priority:10
}
}
})
config.plugin('preload')
.tap(args => {
args[0].fileBlacklist.push(/runtime~.+\.js$/) //正则匹配runtime文件名，去除该文件的preload
return args
})
}
}
工具模块
const path = require('path')
function resolve(dir){
return path.join(__dirname,dir)
}
基础配置
publicPath: './', // router hash 模式使用
outputDir: 'dist',//输出内容的文件夹
assetsDir: 'static',//编译内容的文件夹
productionSourceMap: false,// 打包时不会生成 .map 文件，加快打包速度
lintOnSave: false ,//关闭格式检查
开发服务器代理
devServer: { // 开发服务器
host: needHost,
port: port,
open: false,
overlay: {
warnings: false,
errors: true
},
proxy: {
'/api': {
target: 'xxxxxxx',
secure: false,
changeOrigin: true, //是否跨域
logLevel: 'debug',
pathRewrite: {
'^/api': '' // pathRewrite 表示的意思是 把/api 替换为空
}
}
}
},
快捷引用
// resolve.alias 设置引入别名
config.resolve.alias.set('@', resolve('src'))
.set('assets', resolve('src/assets'))
.set('api', resolve('src/api'))
.set('views', resolve('src/views'))
.set('components', resolve('src/components'))
preserveWhitespace
vue打包保留标签的空白
cheap-source-map
根据环境变量， 设置调试查看源代码
/*
source-map: 一种 提供源代码到构建后代码映射 技术 （如果构建后代码出错，可以通过映射追踪到源代码错误）
格式：[inline- | hidden- | eval-][nosources-][cheap-[module-]]source-map
可以任意排列，但[]的顺序不能乱
具体介绍
source-map: 在外部生成一个文件
在控制台会显示 错误代码准确信息 和 源代码的错误位置
inline-source-map: 内嵌到bundle.js中
只生成一个source-map
在控制台会显示 错误代码准确信息 和 源代码的错误位置
hidden-source-map: 外部
错误代码错误原因，源代码的错误位置
不能追踪源代码错误，只能提示到构建后代码的错误位置
eval-source-map： 内嵌
每一个文件都生成对应的source-map
错误代码准确信息，源代码的错误位置
nosources-source-map: 外部
错误代码准确信息，没有任何源代码信息
cheap-source-map: 外部
错误代码准确信息，源代码的错误位置
只能精准到行
cheap-module-source-map: 外部
错误代码准确信息，源代码的错误位置
module会将loader的source-map加入
内嵌与外部的区别： 1.外部生成单独的文件，内嵌没有 2.内嵌构建速度快
这么多source-map如何选择？
开发环境：速度快，调试更友好
速度快（ eval>inline>cheap>··· ）
组合eval-cheap-source-map > eval-source-map
调试更友好
source-map > cheap-module-source-map > cheap-source-map
最终结果：cheap-module-source-map 和 eval-source-map (vuecli与react脚手架默认)
生产环境：源代码要不要隐藏？调试要不要更友好
内嵌会让代码体积变大，所以在生产环境下不用内嵌
nosources-source-map 全部隐藏
hidden-source-map 只隐藏源代码，会提示构建后代码错误信息
最终结果：source-map 和 cheap-module-source-map
*/
runtimeChunk
根据路由驱动页面的 runtime 代码默认情况是包含在 build 后的 app.hash.js 内的，如果我们改动其他路由，就会导致 runtime 代码改变。从而不光我们改动的路由对应的页面 js 会变，含 runtime 代码的 app.hash.js 也会变，对用户体验是非常不友好的。
为了解决这个问题要设定 runtime 代码单独抽取打包;
script-ext-html-webpack-plugin
但是 runtime 代码由于只是驱动不同路由页面的关系，代码量比较少，请求 js 的时间都大于执行时间了，所以使用 script-ext-html-webpack-plugin 插件将其内链在 index.html 中比较友好。所有这两个一般配合使用。
configureWebpack：
optimization: {
runtimeChunk: true
},
plugins: [
new ScriptExtHtmlWebpackPlugin({
inline: /runtime~.+\.js$/ //正则匹配runtime文件名
})
]
chainWebpack：
config
.plugin('ScriptExtHtmlWebpackPlugin')
.after('html')
.use('script-ext-html-webpack-plugin', [
{
// `runtime` must same as runtimeChunk name. default is `runtime`
inline: /runtime\..*\.js$/
}
])
.end()
config.optimization.runtimeChunk('single')
splitChunks
如果使用了某些长期不会改变的库，像 element-ui ，打包完成有 600 多 KB ，包含在默认 vendor 中显然不合适，每次用户都要加载这么大的文件体验不好，所以要单独打包：
chainWebpack:
config.optimization.splitChunks({
chunks: 'all',
cacheGroups: {
commons: {
name: 'chunk-commons',
test: resolve('src/components'), // can customize your rules
minChunks: 3, // minimum common number
priority: 5,
reuseExistingChunk: true
},
libs: {
name: 'chunk-libs',
chunks: 'initial', // only package third parties that are initially dependent
test: /[\\/]node_modules[\\/]/,
priority: 10
},
elementUI: {
name: 'chunk-elementUI',
priority: 20,
test: /[\\/]node_modules[\\/]_?element-ui(.*)/
},
}
})
preload 预加载
提前预加载提高切换路由的体验
config.plugin('preload').tap(() => [
{
rel: 'preload',
fileBlacklist: [/\.map$/, /hot-update\.js$/, /runtime\..*\.js$/],
include: 'initial'
}
])
config.plugins.delete('prefetch')
这里要把 runtime 代码的 preload 去掉。
环境配置
.env.production 线上环境打包 // vue-cli-service serve
.env.test 测试环境打包 // vue-cli-service test:unit
.env.development 开发环境打包 // vue-cli-service build 和 vue-cli-service test:e2eo
.emv.staging 使用mode 打包 -- vue-cli-service -- mode staging
.env.local. 本地环境变量，会被 git 忽略上传
环境变量
NODE_ENV、BASE_URL、VUE_APP_ 开头的变量才能通过 webpacl.DefinePlugin静态的嵌入到客户端的代码中
html-webpack-plugin
会处理 public/index.html 文件。在构建过程中，资源链接会被自动注入。
可以配置多页面入口:
{
entry: 'index.js',
output: {
path: __dirname + '/dist',
filename: 'index_bundle.js'
},
plugins: [
new HtmlWebpackPlugin(),
new HtmlWebpackPlugin({
filename: 'test.html',
template: 'src/assets/test.html'
})
]
}
可以修改默认参数：
Options:{
title:
filename:
.....
}
config导出
导出vue默认webpack设置
vue inspect > output,js
