手撕vue-cli配置——utils.js篇
utils.js文件主要是用来处理各种css loader的,比如css-loader,less-loader等。
//引入path模块 const path = require('path') //引入之前的config模块 const config = require('../config') //引入“extract-text-webpack-plugin”,它的作用是打包后将生成css文件通过link的方式引入到html中,如果不使用这个插件,那么css就打包到<head>的style中 const ExtractTextPlugin = require('extract-text-webpack-plugin') //引入package.json const pkg = require('../package.json')
exports.assetsPath = function (_path) { //结合config文件的代码可以知道,当环境为生产环境时,assetSubDirectory为“static”,开发环境也是“static” const assetsSubDirectory = process.env.NODE_ENV === 'production' ? config.build.assetsSubDirectory : config.dev.assetsSubDirectory // path.posix.join()是path.join的一种兼容性写法,它的作用是路径的拼接,比如path.posix.join("/c/aa',"bb"); // "c/aa/bb" return path.posix.join(assetsSubDirectory, _path) }
//用来生成Loader的函数 ,本身可以用在vue-loader的配置上(vue-loader.config.js文件,以后我会提这个文件),同时也是为styleLoader函数使用(后面说) exports.cssLoaders = function (options) { //如果没有传参就默认空对象 options = options || {} //配置css-loader,css-loader可以让处理css中的@import或者url() const cssLoader = { loader: 'css-loader', options: { sourceMap: options.sourceMap } } //配置postcss-loader,主要功能是补全css中的兼容性前缀,比如“-webkit-”等 var postcssLoader = { loader: 'postcss-loader', options: { sourceMap: options.sourceMap } } //生成loader的私有方法 function generateLoaders (loader, loaderOptions) { //参数的usePostCss属性是否为true,是就使用两个loader,否则只使用css-loader const loaders = options.usePostCSS ? [cssLoader, postcssLoader] : [cssLoader] if (loader) { //给generateLoaders传loader参数的话,比如“less或者sass”,就将这个loader的配置传到loaders数组中 loaders.push({ loader: loader + '-loader', //Object.assign()是es6的语法,用来合并对象 options: Object.assign({}, loaderOptions, { sourceMap: options.sourceMap }) }) } //如果options参数的extract属性为true,就使用extract text plugin将css抽成单独的文件,否则就将css写进style里 if (options.extract) { return ExtractTextPlugin.extract({ use: loaders, //vue-style-loader可以理解为vue版的style-loader,它可以将css放进style中 fallback: 'vue-style-loader' }) } else { return ['vue-style-loader'].concat(loaders) } } return { //返回各种loader css: generateLoaders(), postcss: generateLoaders(), less: generateLoaders('less'), sass: generateLoaders('sass', { indentedSyntax: true }), scss: generateLoaders('sass'), stylus: generateLoaders('stylus'), styl: generateLoaders('stylus') } }
//生成开发环境下loader的配置,使用在(webpack.dev.conf.js中) exports.styleLoaders = function (options) { const output = [] //调用cssLoaders方法,返回loaders的对象 const loaders = exports.cssLoaders(options) //遍历每一个loader,并配置成对应的格式,传给output数组 for (const extension in loaders) { const loader = loaders[extension] output.push({ test: new RegExp('\\.' + extension + '$'), use: loader }) } return output }