VUE-LOADER配置简述

前注：

文档全文请查看 根目录的文档说明。

如果可以，请给本项目加【Star】和【Fork】持续关注。

有疑义请点击这里，发【Issues】。

DEMO地址

0、使用说明

首先你得会用 Vue.js，不然可能对本文部分内容无法理解

安装：

npm install

运行：

// 开发模式（推荐使用这个）
npm run dev

// 普通模式（需要执行后手动刷新页面）
npm run test

单独安装 Vue-loader：

1. 首先要有 Vue；
2. 其次解析 vue 文件还要 vue-template-compiler；
3. 解析 css 内容当然还要 css-loader，以及配套的 style-loader。

npm i --save vue
npm i --save vue-loader
npm i --save vue-template-compiler
npm i --save css-loader
npm i --save style-loader

通过以上安装，至少可以开始使用了

1、概述

简单来说，vue-loader 就是处理 .vue 文件的。

本文除了涉及到 webpack 中 vue-loader 的使用方法外，还包括 .vue 文件的一些独有使用方法。

但单独一个 vue-loader 并不能解决问题，因此还需要一些其他的东西。

【1】 vue-template-compiler：关于他的作用，根据 readme.md 文件中所介绍的：

This package can be used to pre-compile Vue 2.0 templates into render functions to avoid runtime-compilation overhead and CSP restrictions. You will only need it if you are writing build tools with very specific needs. In most cases you should be using vue-loader or vueify instead, both of which use this package internally.

大致意思就是说，这个用于把 Vue 的模板文件（应该指.vue）预编译为渲染函数，避免运行时再编译带来的性能开销。

就是说 .vue 文件，在 js 执行时再拆开，然后使用是会消耗很多性能的。

一般情况下，不需要单独用他，用 vue-loader 就行了（但是你却需要单独安装他，安装 vue-loader 时是不带这个的）。

【2】 解析 css 内容当然还要 css-loader，以及配套的 style-loader。

根据你的需要，可能还需要更多，但一般情况下，只需要你单独安装好这 2 个就行了（安装vue-laoder不会附带安装这 2 个）。

2、配置

2.1、默认配置

默认配置下，vue-loader只具备基础功能：

【1】.vue 文件拆解：

• 将 .vue 文件拆解成可用的三部分，然后扔到打包后的 .js 文件；

【2】HMR功能：

• 默认支持 HMR 功能（DEMO里已预置，执行 npm run dev 可以通过使用）；
• 如果对规则感兴趣的，请参照官网说明：热重载 vue-loader

【3】css局部作用域：

• 支持组件的 css 使用局部作用域，在 style 标签添加 scoped 即可。
• 例如：<style scoped></style>，这样的话，该组件内的样式只会对该组件生效（原理是给对应的组件加指定属性名，然后 css 选择器里也加上属性选择器）；
• 支持在组件使用 scoped 属性的情况下，让某些样式影响子元素。方法是使用 /deep/ 或 >>> 关键字，该关键字前的选择器，会加局部作用域；该关键字后面的选择器，不会加局部作用域。例如.app /deep/ .child 会被编译为：··.app[data-v-04c2046b] .child··

【4】CSS Modules

• 简单来说，就是可以将 <style></style> 标签内的东西，加了 module 属性后，可以直接在 vue 组件后，获取重命名后的类名。
• 可以用作模拟 css 作用域的解决方案。
• 详细说明见本文【3.1、CSS Modules】

---

需要额外配置才有的功能：

【1】es6代码转换成es5：

• 通过配置，可以将 <script> 里的 es6代码。
• 指例如 created 这个函数里，使用的 es6 代码。
• 而 created 本身即可以用 created: function(){} ，也可以用 created()，都能正常识别），自动通过 babel 编译为 es5 的代码；
• 参照【2.4、使用babel-loader】

【2】图片url

• 加载图片，路径是会被正常处理的，但是仅仅只有路径是不行的。
• 就像 css-loader 也能处理图片的路径，但依然需要 file-loader 来处理图片一样。
• 参照【2.5、图片】

【3】css 预处理器

• 只需要安装对应的 css 预处理器的 loader，以及在 .vue 文件里标识一下，就能被 vue-loader 所使用，无需额外在 webpack.config.js 里配置。
• 使用方法见【2.3、使用css预处理器】

【4】自带 postcss

• 查看 vue-loader 的 package.json， 会发现在 dependencies 里有 postcss。
• 注意不是 postcss-loader，loader 是给 webpack 用的，而postcss 是类似 less、sass 等，更全面的 css 处理器（不止是预处理器）。
• 但是假如我们需要 postcss-loader 的功能，那么是不需要额外安装 postcss-loader 的。
• 详细使用说明参照下面【2.2、使用 postcss 的功能】

2.2、使用 postcss 的功能

之前讲过postcss-loader，点击查看。

假如我们需要在 vue-loader 里，通过 postcss 添加兼容性 css 前缀，很简单。

1、先安装 autoprefixer，

npm install autoprefixer --save

2、兼容性插件的配置，假如我们在 postcss.config.js 里配置，如下写就行了（跟使用 postcss-loader 方法是一样的）

let autoprefixer = require('autoprefixer');

module.exports = {
    plugins: [
        autoprefixer({
            browsers: [
                // 加这个后可以出现额外的兼容性前缀
                "> 0.01%"
            ]Z
        })
    ]
}

这就足够了，无需其他操作。

2.3、使用css预处理器

这里使用 less 作为示例，而 SASS 或者其他，是类似的。

首先要安装 less-loader：

npm i --save less-loader

然后在 .vue 文件，需要使用 less 语法的 <style> 标签里，添加一个属性 lang="less" 就行。

但是，如果你使用的是 webstorm 作为 IDE，那么 webstorm 是无法正常以 less 语法来识别这个的，因此我们还需要额外添加一个属性 type="text/less"。

因此给出示例代码（局部作用域、less语法、支持webstorm识别）：

<style scoped lang="less" type="text/less">
    .child-component {
        .text {
            font-size: 30px;
            font-weight: bold;
        }
    }
</style>

2.4、使用babel-loader

使用 babel 很简单，同样，无需额外配置。

首先参照我写的 babel-loader 这一篇内容，安装 babel-loader 和相关的东西。

然后在项目跟目录下添加 .babelrc 文件，里面的内容和 babel-loader 的配置是一样的。

除此之外，无需其他额外配置。

2.5、图片

引用图片，我们还是需要使用 file-loader ，可能还需要使用 url-loader（根据需要不需要转 base64 字符串）

就假设我们需要同时使用这两个吧，配置起来非常简单。

先安装 file-loader 和 url-loader，参照 url-loader 和 file-loader。

然后配置一波图片匹配在 webpack.config.js，就行了。

{
    test: /\.(png|jpg|jpeg|gif)$/,
    use: [
        {
            loader: 'url-loader',
            options: {
                limit: 8192,
                mimetype: 'image/png',
                name: 'img/[hash].[ext]'
            }
        }
    ]
}

2.6、其他

以以上几个为例，想必大家已经了解了，vue-loader 本身无需特殊配置，也不需要给 .vue 文件添加很多其他的 loader 的处理。

我们只需要安装对应的 loader，然后配置一下 loader 即可。

也就是说，如果要添加某个 loader，大部分只需要安装，不需要额外配置。

假如我们需要额外处理某些 loader，不使用 vue-loader 本身的，也是可以的。

参照官网这个说明 loaders，很简单。

3、vue-loader 独有功能

3.1、CSS Modules

简单来说，就是模块化css。

如果看过我的 css-loader 这一篇的【2.8、modules等】，可能就能体会到 css-loader 的这个功能是如何在这里实现的了。

例如，假如我在 .vue 文件里加了以下标签。

<!-- 调用方法示例：<div :class="$style.test"> -->
<style module>
    .test {
        border: 2px solid gold;
    }
</style>

<!-- 调用方法示例： <div :class="foo.bar"> -->
<style module="foo">
    .bar {
        position: relative;
        animation: move 2s linear infinite;
    }

    @keyframes move {
        0% {
            left: 0;
        }
        50% {
            left: 100px;
        }
        100% {
            left: 0;
        }
    }
</style>

那么编译后，代码会变成以下情况：

<style type="text/css">
    ._1MwiT3GNpEBkInFbvenNqf_1 {
        border: 2px solid gold;
    }
</style>

<style type="text/css">
    ._2zuIotdSd4Qw4JyIOKek2x_2 {
        position: relative;
        animation: _1Uijvgp95FT2K79a3BqAeg_2 2s linear infinite;
    }

    @keyframes _1Uijvgp95FT2K79a3BqAeg_2 {
        0% {
            left: 0;
        }
        50% {
            left: 100px;
        }
        100% {
            left: 0;
        }
    }
</style>

也就是说，加上 modules 属性后，原本的样式名会被重命名，然后可以通过变量来获取重命名后的名字。

获取方法如下：

【1】只有 module 属性的 <style> 标签中的 class 类名，通过 $style.类名 来获取，例如： $style.test；

【2】module属性被命名（例如 module="foo"），通过 module名.类名来获取，例如： foo.bar；

这个变量在对应组件中，可以通过 this.$style.test 或者 foo.bar 来获取，

console.log(this.$style);    // {test: "_1MwiT3GNpEBkInFbvenNqf_1"}

4、问题和解决

4.1、引入 vue 但是不能正常运行

打包后，无法正常运行。查看 console，有以下报错：

You are using the runtime-only build of Vue where the template compiler is not available. Either pre-compile the templates into render functions, or use the compiler-included build.

原因可以参照这个文章Vue 2.0 升（cai）级（keng）之旅。

这里简单总结一下，就是默认引入的 Vue，并不是 vue.js，而是 vue.common.js，而后者是运行时环境使用的。

解决方法很简单：

【方法一】更改引入路径：

引入的更改为：import Vue from 'vue/dist/vue.js'

【方法二】添加别名：

在 webpack.config.js 里添加别名：

resolve: {
    alias: {
        'Vue': 'vue/dist/vue.js'
    }
}

注意，如果添加别名的话，alias 属性的 key，需要和引入的 大小写要保持一致。

即这里的是大写字母开头的 Vue，那么引入的时候也应该是大写字母开头的：import Vue from 'Vue'

4.2、后缀名省略

一般情况下，如果要引入 child.vue，那么正常情况下，会使用 import child from './child.vue' 来实现

那么假如我想省略掉后缀名，写成 import child from './child' ，该怎么办？

解决办法：

修改 webpack.config.js 中的 resolve 属性，例如：

// 以上省略
resolve: {
    extensions: ['.js', '.vue'],
//以下省略

就可以无后缀名引用 .vue 结尾的文件了，注意，如果有相同名字但不同后缀名的，有先后顺序。