写点什么

Vue 进阶(五十一): vue-cli 脚手架 webpack.base.conf.js 配置文件讲解

发布于: 56 分钟前
Vue进阶(五十一): vue-cli 脚手架 webpack.base.conf.js 配置文件讲解

一、前言

webpack.base.conf.js 文件是vue开发环境和生产环境wepack相关配置文件,主要用来处理各种文件的配置。


// 引入nodejs路径模块var path = require('path')// 引入utils工具模块,utils主要用来处理css-loader和vue-style-loader的var utils = require('./utils')// 引入config目录下的index.js配置文件,主要用来定义一些开发和生产环境的属性var config = require('../config')// vue-loader.conf配置文件是用来解决各种css文件的,定义了诸如css,less,sass之类的和样式有关的loadervar vueLoaderConfig = require('./vue-loader.conf')// 此函数是用来返回当前目录的平行目录的路径,因为有个'..'function resolve (dir) {  return path.join(__dirname, '..', dir)}
module.exports = { entry: { // 入口文件是src目录下的main.js app: './src/main.js' }, output: { // 路径是config目录下的index.js中的build配置中的assetsRoot,也就是dist目录 path: config.build.assetsRoot, // 文件名称这里使用默认的name也就是main filename: '[name].js', // 上线地址,也就是真正的文件引用路径,如果是production生产环境,其实这里都是 '/' publicPath: process.env.NODE_ENV === 'production' ? config.build.assetsPublicPath : config.dev.assetsPublicPath }, resolve: { // resolve是webpack的内置选项,顾名思义,决定要做的事情,也就是说当使用 import "jquery",该如何去执行这件事 // 情就是resolve配置项要做的,import jQuery from "./additional/dist/js/jquery" 这样会很麻烦,可以起个别名简化操作 extensions: ['.js', '.vue', '.json'], // 省略扩展名,也就是说.js,.vue,.json文件导入可以省略后缀名,这会覆盖默认的配置,所以要省略扩展名在这里一定要写上 alias: { //后面的$符号指精确匹配,也就是说只能使用 import vuejs from "vue" 这样的方式导入vue.esm.js文件,不能在后面跟上 vue/vue.js 'vue$': 'vue/dist/vue.esm.js', // resolve('src') 其实在这里就是项目根目录中的src目录,使用 import somejs from "@/some.js" 就可以导入指定文件,是不是很高大上 '@': resolve('src') } }, // module用来解析不同的模块 module: { rules: [ { test: /\.(js|vue)$/, // 也就是说,对.js和.vue文件在编译之前进行检测,检查有没有语法错误 loader: 'eslint-loader', // 此选项指定enforce: 'pre'选项可以确保,eslint插件能够在编译之前检测,如果不添加此项,就要把这个配置项放到末尾,确保第一个执行 enforce: 'pre', // include选项指明这些目录下的文件要被eslint-loader检测,还有一个exclude表示排除某些文件夹 include: [resolve('src'), resolve('test')], // options表示传递给eslint-loader的参数 options: { // formatter是参数的名称,eslint-friendly-formatter是eslint的一个报告总结插件,也就是说eslint的检测报告非常难看懂,这个插件就是整理这些报告方便查阅的 formatter: require('eslint-friendly-formatter') } }, { test: /\.vue$/, // 对vue文件使用vue-loader,该loader是vue单文件组件的实现核心,专门用来解析.vue文件的 loader: 'vue-loader', // 将vueLoaderConfig当做参数传递给vue-loader,就可以解析文件中的css相关文件 options: vueLoaderConfig }, { test: /\.js$/, // 对js文件使用babel-loader转码,该插件是用来解析es6等代码 loader: 'babel-loader', // 指明src和test目录下的js文件要使用该loader include: [resolve('src'), resolve('test')] }, { test: /\.(png|jpe?g|gif|svg)(\?.*)?$/, // 对图片相关的文件使用 url-loader 插件,这个插件的作用是将一个足够小的文件生成一个64位的DataURL // 可能有些老铁还不知道 DataURL 是啥,当一个图片足够小,为了避免单独请求可以把图片的二进制代码变成64位的 // DataURL,使用src加载,也就是把图片当成一串代码,避免请求,神不神奇?? loader: 'url-loader', options: { // 限制 10000 个字节一下的图片才使用DataURL limit: 10000, name: utils.assetsPath('img/[name].[hash:7].[ext]') // 这个函数执行结果是 /img/[name].[hash:7].[ext] // 不知道吧 name 设置成 /img/[name].[hash:7].[ext] 意欲何为,猜测应该是输出图片的路径或者是解析图片的路径 } }, { test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/, // 字体文件处理,和上面一样 loader: 'url-loader', options: { limit: 10000, name: utils.assetsPath('fonts/[name].[hash:7].[ext]') } } ] }}
复制代码


(1)下面是vue-loader.conf.js配置文件的解释,如果你看过我关于utils的解释,下面很好懂


// utils配置文件用来解决css相关文件loadervar utils = require('./utils')// 生产和开发环境的相关属性var config = require('../config')// 判断当前是否生产环境var isProduction = process.env.NODE_ENV === 'production'
module.exports = { // 调用utils配置文件中的cssLoaders方法,用来返回配置好的css-loader和vue-style-loader loaders: utils.cssLoaders({ sourceMap: isProduction ? config.build.productionSourceMap : config.dev.cssSourceMap, // 这一句话表示如何生成map文 extract: isProduction // 这一项是自定义配置项,设置为true表示生成单独样式文件 })}
复制代码

二、注

  • 对于文件小于10000byte,在生成的代码用中base64来替代;

  • 大于10000byte,按[name].[hash:7].[ext]的命名方式放到static/img下面,方便做cache

  • 因为项目中会有动态引入而无法提前通过loader加载的图片,用CopyWebpackPlugin放到dist目录下。所以最后build完的图片资源就是两部分:一部分是dev下的整个图片文件夹(被复制了一份),另外就是经过url-loader处理过的dist/img下带hash的图片。

三、拓展阅读

发布于: 56 分钟前阅读数: 2
用户头像

No Silver Bullet 2021.07.09 加入

岂曰无衣 与子同袍

评论

发布
暂无评论
Vue进阶(五十一): vue-cli 脚手架 webpack.base.conf.js 配置文件讲解