彻底搞懂并解决vue-cli4中图片显示的问题

在基于vue-cli实际开发过程中，很多小伙伴都会遇到关于图片显示的困扰，不管怎么设置，图片就是显示不出来，今天我们来详细说说这个问题。

图片无法显示，绝大部门的情况是图片路径问题，要搞懂路径问题，分别有相对路径与绝对路径

实际开发中使用图片最多的场景有以下三种：

1、手动引入

    <template>
        <img :src="imgurl" />
    </template>
    <script>
        import logo from '../img/logo.png'
        // 或
        const logo = require('../img/logo.png');
        export default{
            data(){
                return {
                    imgurl:logo
                }
            }
        }
    </script>

使用require或import方式引入图片时，引入路径是相对于当前文件路径的，编译时webpack会介入并把路径处理成服务器绝路径

2、相对路径

    <img src="../img/logo.png" />

在vue-cli中使用相对路径时，webpack会自动介入，上面的代码在编译时自动变成

    <img src="require('../img/logo.png')"

最终在页面的显示效果与以上手动引入方式一致

3、绝对路径

    <img src="/img/logo.png" />

使用绝对路径，首先要了解服务器根目录在哪，大家都知道，在vue-cli的项目本身自带一个服务器的，基于webpack-dev-server模块，根目录为public文件夹，所以，使用绝对路径的方式展示图片，必须把图片放到public文件夹，这也是最简单的一种方式，这种方式webpack不会介入，所以最终显示效果与引入时的代码一致，代码如下：

最终显示效果

4、数据中的图片

    <template>
        <ul>
            <li><img :src="item.imgurl" v-for="item in goodslist" /></li>
        </ul>
    </template>
    <script>
        export default{
            data(){
                return {
                    goodslist:[{name:'goods1',imgurl:'../img/goods1.png'},{name:'goods2',imgurl:'../img/goods2.png'},{name:'goods3',imgurl:'../img/goods3.png'},
                    ]
                }
            }
        }
    </script>

这种情况应该是最常见的（ajax请求数据回来，然后遍历写入到页面结构中），这个时候绑定到src属性的是一个变量，无法直接手动import或require，如果直接使用imgurl属性中的路径，webpack不会介入处理，所以以上代码是无法正常显示图片的，解决方法如下：

• 方法1：遍历数据，使用前先手动require

  在前端，模块的引入默认是不支持动态引入的（即不支持：require(变量)），如下

      this.goodslist = this.goodslist.map(item=>{
          // 虽然路径是正确的，但以下方式引入会报`Cannot find module '../assets/logo.png'`
          // item.imgurl = require(item.imgurl);
  
          // 正确的方式为
          item.imgurl = require('../img'+item.imgurl.replace('../img',''))
          return item;
      })

  有小伙伴可能会觉得奇怪，为什么这样做就可以了，Webpack 在处理动态名称模块名的时候，会直接将能识别的静态路径和路径下的所有子文件都作为模块处理，如：require('../img'+imgName)，能识别到../img目录，并将该目录下所有文件当做模块处理，做成一个Map映射以便后面进行匹配，所以能识别到对应的文件，其原理是require.context，属性如下：

  • require.context(directory,useSubdirectories,regExp)

    • directory {String} -读取文件的路径（一般为一个目录）
    • useSubdirectories {Boolean} -是否遍历文件的子目录，默认false
    • regExp {RegExp} -匹配文件的正则，默认匹配所有文件

    方法返回一个函数（假设为fn），传入图片路径（不包含directory的路径）可得到处理过的图片对应路径（如：fn('./goods1.png')，） ，上面的代码等效于

```js
    this.goodslist = this.goodslist.map(item=>{
        const fn = require.context('../img',false,/^\./);
        const file = item.replace('../img','.')
        item.imgurl = fn(file);
        return item;
    })
```

• 方法2：在数据库端直接使用绝对路径，并把所需图片放到public目录中

  imgurl的格式为: '/img/goods1.png'