vue-cli脚手架build目录下utils.js工具配置文件详解

2023-09-08 04:43:04 328

此文章用来解释vue-cli脚手架build目录中的utils.js配置文件

1.此配置文件是vue开发环境的wepack相关配置文件，主要用来处理css-loader和vue-style-loader

2.关于注释•当涉及到较复杂的解释我将通过标识的方式(如（1）)将解释写到单独的注释模块，请自行查看

3.上代码

//引入nodejs路径模块
varpath=require('path')
//引入config目录下的index.js配置文件
varconfig=require('../config')
//引入extract-text-webpack-plugin插件，用来将css提取到单独的css文件中
//详情请看(1)
varExtractTextPlugin=require('extract-text-webpack-plugin')
//exports其实就是一个对象，用来导出方法的最终还是使用module.exports，此处导出assetsPath
exports.assetsPath=function(_path){
//如果是生产环境assetsSubDirectory就是'static'，否则还是'static'，哈哈哈
varassetsSubDirectory=process.env.NODE_ENV==='production'
?config.build.assetsSubDirectory
:config.dev.assetsSubDirectory
//path.join和path.posix.join的区别就是，前者返回的是完整的路径，后者返回的是完整路径的相对根路径
//也就是说path.join的路径是C:a/a/b/xiangmu/b，那么path.posix.join就是b
returnpath.posix.join(assetsSubDirectory,_path)
//所以这个方法的作用就是返回一个干净的相对根路径
}

//下面是导出cssLoaders的相关配置
exports.cssLoaders=function(options){
//options如果没值就是空对象
options=options||{}
//cssLoader的基本配置
varcssLoader={
loader:'css-loader',
options:{
//options是用来传递参数给loader的
//minimize表示压缩，如果是生产环境就压缩css代码
minimize:process.env.NODE_ENV==='production',
//是否开启cssmap，默认是false
sourceMap:options.sourceMap
}
}

//generateloaderstringtobeusedwithextracttextplugin
functiongenerateLoaders(loader,loaderOptions){
//将上面的基础cssLoader配置放在一个数组里面
varloaders=[cssLoader]
//如果该函数传递了单独的loader就加到这个loaders数组里面，这个loader可能是less,sass之类的
if(loader){
loaders.push({
//加载对应的loader
loader:loader+'-loader',
//Object.assign是es6的方法，主要用来合并对象的，浅拷贝
options:Object.assign({},loaderOptions,{
sourceMap:options.sourceMap
})
})
}

//ExtractCSSwhenthatoptionisspecified
//(whichisthecaseduringproductionbuild)
//注意这个extract是自定义的属性，可以定义在options里面，主要作用就是当配置为true就把文件单独提取，false表示不单独提取，这个可以在使用的时候单独配置，瞬间觉得vue作者好牛逼
if(options.extract){
returnExtractTextPlugin.extract({
use:loaders,
fallback:'vue-style-loader'
})
}else{
return['vue-style-loader'].concat(loaders)
}
//上面这段代码就是用来返回最终读取和导入loader，来处理对应类型的文件
}

//https://vue-loader.vuejs.org/en/configurations/extract-css.html
return{
css:generateLoaders(),//css对应vue-style-loader和css-loader
postcss:generateLoaders(),//postcss对应vue-style-loader和css-loader
less:generateLoaders('less'),//less对应vue-style-loader和less-loader
sass:generateLoaders('sass',{indentedSyntax:true}),//sass对应vue-style-loader和sass-loader
scss:generateLoaders('sass'),//scss对应vue-style-loader和sass-loader
stylus:generateLoaders('stylus'),//stylus对应vue-style-loader和stylus-loader
styl:generateLoaders('stylus')//styl对应vue-style-loader和styl-loader
}
}

//Generateloadersforstandalonestylefiles(outsideof.vue)
//下面这个主要处理import这种方式导入的文件类型的打包，上面的exports.cssLoaders是为这一步服务的
exports.styleLoaders=function(options){
varoutput=[]
//下面就是生成的各种css文件的loader对象
varloaders=exports.cssLoaders(options)
for(varextensioninloaders){
//把每一种文件的laoder都提取出来
varloader=loaders[extension]
output.push({
//把最终的结果都push到output数组中，大事搞定
test:newRegExp('\\.'+extension+'$'),
use:loader
})
}
returnoutput
}

注释

(1)extract-text-webpack-plugin插件是用来将文本从bundle中提取到一个单独的文件中

基本使用方法如下

constExtractTextPlugin=require("extract-text-webpack-plugin");
module.exports={
module:{
rules:[
{
test:/\.css$/,//主要用来处理css文件
use:ExtractTextPlugin.extract({
fallback:"style-loader",//fallback表示如果css文件没有成功导入就使用style-loader导入
use:"css-loader"//表示使用css-loader从js读取css文件
})
}
],
plugins:[
newExtractTextPlugin("styles.css")//表示生成styles.css文件
]
}
}

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持毛票票。

vue-cli脚手架build目录下utils.js工具配置文件详解

热门推荐

随机推荐