此文章用来解释vue-cli脚手架build目录中的webpack.base.conf.js配置文件
- 此配置文件是vue开发环境的wepack相关配置文件,主要用来处理各种文件的配置
- 关于注释
- 当涉及到较复杂的解释我将通过标识的方式(如(1))将解释写到单独的注释模块,请自行查看
- 上代码
// 引入nodejs路径模块
var path = require('path')
// 引入utils工具模块,具体查看我的博客关于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之类的和样式有关的loader
// 详情请看(1)
var 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"
// 这样会很麻烦,可以起个别名简化操作
// 省略扩展名,也就是说.js,.vue,.json文件导入可以省略后缀名,
// 这会覆盖默认的配置,所以要省略扩展名在这里一定要写上
extensions: ['.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].[hash:7].[ext]对应的图片使用url-loader测试吧,
// 这个我是真不知道干啥的,如果知道的兄弟,一定要留言给我啊,拜谢
name: utils.assetsPath('img/[name].[hash:7].[ext]') // 这个函数执行结果是 /img/[name].[hash:7].[ext]
// 不知道吧 name 设置成 /img/[name].[hash:7].[ext] 意欲何为,
// 猜测应该是输出图片的路径或者是解析图片的路径
// 预防同名文件浏览器不加载 每次打包的[hash:7]不同
}
},
{
test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/,
// 字体文件处理,和上面一样
loader: 'url-loader',
options: {
limit: 10000,
name: utils.assetsPath('fonts/[name].[hash:7].[ext]')
}
}
]
}
}