vue-cli脚手架build目录下utils.js工具配置文件详解(转载+自己补充)
转载自http://www.cnblogs.com/ye-hcj/p/7078047.html,另添加了一点补充此文章用来解释vue-cli脚手架build目录中的utils.js配置文件此配置文件是vue开发环境的wepack相关配置文件,主要用来处理css-loader和vue-style-loader关于注释当涉及到较复杂的解释我将通过标识的方式(如(1))将解释写到单独的注释模块,请自行查
·
转载自http://www.cnblogs.com/ye-hcj/p/7078047.html,另添加了一点补充
此文章用来解释vue-cli脚手架build目录中的utils.js配置文件
- 此配置文件是vue开发环境的wepack相关配置文件,主要用来处理css-loader和vue-style-loader
- 关于注释
- 当涉及到较复杂的解释我将通过标识的方式(如(1))将解释写到单独的注释模块,请自行查看
- 上代码
'use strict'
// 引入nodejs路径模块
const path = require('path')
// 引入config目录下的index.js配置文件
const config = require('../config')
// 引入extract-text-webpack-plugin插件,用来将css提取到单独的css文件中
// 详情请看(1)
const ExtractTextPlugin = require('extract-text-webpack-plugin')
// 引入package.json后边会用到
const packageConfig = require('../package.json')
// 是配移动端屏幕自适应像素兼容性75px==1rem
const px2remLoader = {
loader: 'px2rem-loader',
options: {
remUnit: 75
}
}
// exports其实就是一个对象,用来导出方法的最终还是使用module.exports,此处导出assetsPath
exports.assetsPath = function (_path) {
// 如果是生产环境assetsSubDirectory就是'static',否则还是'static',哈哈哈
const assetsSubDirectory = 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
return path.posix.join(assetsSubDirectory, _path)
// 所以这个方法的作用就是返回一个干净的相对根路径
}
// 下面是导出cssLoaders的相关配置
exports.cssLoaders = function (options) {
// options如果没值就是空对象
options = options || {}
// cssLoader的基本配置
const cssLoader = {
loader: 'css-loader',
options: {
// options是用来传递参数给loader的
// minimize表示压缩,如果是生产环境就压缩css代码
minimize: process.env.NODE_ENV === 'production',
// 是否开启cssmap,默认是false
sourceMap: options.sourceMap
}
}
// 为css自动生成兼容性前缀
const postcssLoader = {
loader: 'postcss-loader',
options: {
sourceMap: options.sourceMap
}
}
// generate loader string to be used with extract text plugin
function generateLoaders (loader, loaderOptions) {
// 将上面的基础cssLoader配置、兼容性前缀配置、自适应配置放在一个数组里面
const loaders = options.usePostCSS ? [cssLoader, postcssLoader, px2remLoader] : [cssLoader, px2remLoader]
// 如果该函数传递了单独的loader就加到这个loaders数组里面,这个loader可能是less,sass之类的
if (loader) {
loaders.push({
// 加载对应的loader
loader: loader + '-loader',
// Object.assign是es6的方法,主要用来合并对象的,浅拷贝
options: Object.assign({}, loaderOptions, {
sourceMap: options.sourceMap
})
})
}
// Extract CSS when that option is specified
// (which is the case during production build)
// 注意这个extract是自定义的属性,可以定义在options里面,主要作用就是当配置为true就把文件单独提取,
// false表示不单独提取,这个可以在使用的时候单独配置,瞬间觉得vue作者好牛逼
if (options.extract) {
return ExtractTextPlugin.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
}
}
// Generate loaders for standalone style files (outside of .vue)
// 下面这个主要处理import这种方式导入的文件类型的打包,上面的exports.cssLoaders是为这一步服务的
exports.styleLoaders = function (options) {
const output = []
// 下面就是生成的各种css文件的loader对象
const loaders = exports.cssLoaders(options)
for (const extension in loaders) {
// 把每一种文件的laoder都提取出来
const loader = loaders[extension]
output.push({
// 把最终的结果都push到output数组中,大事搞定
test: new RegExp('\\.' + extension + '$'),
use: loader
})
}
return output
}
详情1
extract-text-webpack-plugin插件是用来将文本从bundle中提取到一个单独的文件中(该插件的主要是为了抽离css样式,防止将样式打包在js中引起页面样式加载错乱的现象),基本使用方法如下
const ExtractTextPlugin = require("extract-text-webpack-plugin");
module.exports = {
module: {
rules: [
{
test: /\.css$/, //主要用来处理css文件
// use:指需要什么样的loader去编译文件,这里由于源文件是.css所以选择css-loader
// fallback:编译后用什么loader来提取css文件
// publicfile:用来覆盖项目路径,生成该css文件的文件路径
use: ExtractTextPlugin.extract({
fallback: "style-loader", // fallback表示如果css文件没有成功导入就使用style-loader导入
use: "css-loader" // 表示使用css-loader从js读取css文件
})
}
],
plugins: [
new ExtractTextPlugin("styles.css") //表示生成styles.css文件
]
}
}
更多推荐
已为社区贡献11条内容
所有评论(0)