"use strict"//引入node.js路劲模块const path = require("path")//引入utils工具模块，utils主要用来处理css-loader和vue-style-loader的const utils = require("./utils")//引入config目录下的index.js配置文件，主要来定义一些开发和生产环境的属性const config = require("../config")//vue-loader.conf配置文件是用来解决各种CSS文件的，定义了诸如css,less,sass之类的和样式有关的loaderconst vueLoaderConfig = require("./vue-loader.conf")//此函数是用来返回目前目录的平行目录的路径，因为有个".."function resolve (dir) { return path.join(__dirname, "..", dir)}//eslint 的检测规则const createLintingRule = () => ({ //对js和vue 文件进行eslint 检查 test: /\.(js|vue)$/, //使用eslint-loader loader: "eslint-loader", //enforce执行的意思 有两个值 pre post //pre是在其他规则执行之前执行 post是在其他规则执行之后执行 enforce: "pre", //进行检测的文件目录包括哪些 调用了路径函数， include: [resolve("src"), resolve("test")], options: { //使用第三方的插件进行eslint 检测 formatter: require("eslint-friendly-formatter"), //是否输出eslint报错信息 emitWarning: !config.dev.showEslintErrorsInOverlay }})//webpack的配置，可以理解成是开发环境和正式环境的一些公共配置module.exports = { //webpack 解析时根目录地址如果此文件在跟目录这句话就不用写 context: path.resolve(__dirname, "../"), 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: { //转换解析规则 //1.test是用来解析所有此后缀名的文件， //2.loader我们用什么npm什么形式的loader去解析 //3.include是代表我们解析的文件只包含那些东西 //4.options解析文件参数设置 具体看下面的解释 rules: [ ...(config.dev.useEslint ? [createLintingRule()] : []), { 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"), resolve("node_modules/webpack-dev-server/client")] }, { 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: /\.(mp4|webm|ogg|mp3|wav|flac|aac)(\?.*)?$/, loader: "url-loader", options: { limit: 10000, name: utils.assetsPath("media/[name].[hash:7].[ext]") } }, { //对字体文件进行解析 test: /\.(woff2?|eot|ttf|otf)(\?.*)?$/, loader: "url-loader", options: { limit: 10000, name: utils.assetsPath("fonts/[name].[hash:7].[ext]") } } ] }, node: { // 是否 polyfill 或 mock // prevent webpack from injecting useless setImmediate polyfill because Vue // 源包含它（虽然仅在本地使用) // source contains it (although only uses it if it"s native). setImmediate: false, // 预防webpack从注入模拟节点到node原生模块 // prevent webpack from injecting mocks to Node native modules // that does not make sense for the client 这对客户端没有影响 // that does not make sense for the client dgram: "empty", fs: "empty", net: "empty", tls: "empty", child_process: "empty" }}
