vue3：加载本地图片等静态资源

Posted 2023-04-10 Lvan的前端笔记

背景

在我们用 vue2 + webpack 的时候，加载图片资源是这样用的：

<img :src="require('@/assets/test.png')" />

这样打包后就会触发 file-loader 打包图片资源，在 dist 文件夹中就可以看到这个图片（如果图片较小会打包进代码中变为 base64 引入）。

但是在 vue3 + vite 中，使用这种方式是不行的，vite 中没有 require 会报错。
解决方案 官方文档 中提到了两种方案，今天我来验证一下。

将资源引入为 URL

import chatHealth from '@/assets/chat-health.png'
<img :src="chatHealth" alt="" />

可以看到，由于这张图片较小被打包成为了 base64，所以 dist 文件夹没有输出这个图片。

接下来我拿一张大图试验一下，发现确实打包出来了。

所以这种方法亲测有效。

new URL(url, import.meta.url)

第二种方法是：

<img :src="getImgUrl('chat-health.png')" alt="" />

const getImgUrl = (name: string) => 
  return new URL('../../../../../assets/' + name, import.meta.url).href

使用这种方法，在本地运行的时候可以加载出来图片。

但是发到真实环境（测试/线上），发现找不到文件了，我看了下目录指向的是：

但这个路径并不对，然后我再看打包后的文件

发现打包后的文件并没有这个图片，这里我有点不太懂问题出在哪里？
感觉好像就是 vite 没有去加载这个图片，所以打包文件看不到，并不是因为图片小，我换了一个大图依旧 dist 没有，不知道是不是我哪里操作不对。

结尾

对比这两种方案，我只试验成功了第一种，第二种如果是我哪里操作不对的欢迎指正

vue-cil和webpack中本地静态图片的路径问题解决方案

本地图片动态绑定img的src属性

一般我们在html中或者vue组件文件中引用图片是这样，这是不需要做特别处理的

我们将图片放入assets中或者重新建立个文件夹img什么的都可以，随意～

但是我们这时候可能会有个需求就是我们要动态绑定一组本地图片

1 将图片当成模块先引进来，再绑定

但是这种做法局限性比较大，模块化差，代码不好看 。

如果我做的是纯静态的网站展示，有许多的本地静态资源需要加载，里面包括本地数据和本地图片混合的好几组，那不是要麻烦死～

1.1 所以我们需要三步

第一步我们在src下面建立一个json文件夹里面放置静态的json数据

第二步将所有的静态图片资源放在和src同级目录下的static文件夹下

第三步你的路径可以写成自然的\'../../static/img/xxx.png\' 也可以按照红框中的写法（这种写法对应的是编译后文件的目录）

这样子按照平常的动态绑定src属性你的图片路径在开发模式下和生产模式下的图片资源路径都是不会出问题的

1.2 小问题

但也有个问题就是这种方式引用图片是不会被url等加载器处理的

上面的红框都是这种方式，最下面的红框是用require的方式将图片引进来的（被当成模块被url-loader处理，加入了hash值）

这个需要看网站本身的性质和具体业务以及个人取舍了，当然也可以混合着用，灵活一点没有死的处理方法！

2 css中的本地图片路径在打包后的问题

你的项目在开发模式下css中用url（）引用图片是正常的，但是打包后图片路径却并没有被处理或者说特别怪异

导致本地图片资源无法加载，是不是有这样的困惑？

只需要在原有的一个插件上添加一段代码即可：

这个插件大家又应该都比较熟悉，就是将css从打包中单独提取出来作为一个文件夹，上面这个是vue-cil的编译模板，大家可以根据这个参考一下

publicPath这个配置属性的具体其他用法大家可以去官网看看，或者看看源码。了解更多