vue3+vite2动态绑定图片优雅解决方案

优雅解决方案在最下面，小伙伴们儿可以直接前往

背景

在vue3+vite2项目中，我们有时候想要动态绑定资源，比如像下面的代码这样：

<template>
    <div>
	    <!-- 动态绑定图片资源 -->
        <img :src="img_src">
    </div>
</template>

<script setup>
import { ref } from 'vue';
// 静态图片资源
const img_src = ref('./1.jpg');
</script>

实际效果是这样：

原因分析

我们注意到，控制台的报错信息GET http://127.0.0.1:5173/1.jpg 404 (Not Found)

• GET：表示向服务器请求资源的方式。
• http://127.0.0.1:5173：表示主机为项目开启的服务器地址以及端口号
• http://127.0.0.1:5173/1.jpg：表示存放在服务器中的图片资源地址。
• 404 (Not Found)：状态码，404表示找不到资源。

问题就出在http://127.0.0.1:5173/1.jpg 这里，项目文件的路径是src/App.vue ，图片的路径是src/1.jpg ，因此，图片在服务器上的存放路径实际应该是http://127.0.0.1:5173/src/1.jpg ，我们直接在浏览器中访问这个地址。

可以看到，成功获取了图片资源。

由于vite打包的机制，造成了路径错误的问题（类似于vue2 + vue-cli项目的动态绑定图片问题）。

解决

目前网上的解决方案有很多，这里列出其中一种受众的，以及笔者在此基础上进一步加强的解决方案。

普遍的解决方案

话不多说，直接列出代码：

<template>
    <div>
	    <!-- 动态绑定图片资源 -->
        <img :src="img_src">
    </div>
</template>

<script setup>
import { ref } from 'vue';
// 静态图片资源
const img_src = ref('./1.jpg');

// 主要代码，利用 new URL().href 进行相对路径的拼接
function getAssetImage(imgSrc) {
  return new URL(imgSrc, import.meta.url).href;
}

// 当然你也可以这样简写，这里用到es6箭头函数
// const getAssetImage = imgSrc => new URL(imgSrc, import.meta.url).href;
</script>

这段代码的重点是new URL().href 和 es6的 import.meta.url 。

• new URL(url, baseUrl).href：路径拼接。比如url是./1.jpg，baseUrl是http://127.0.0.1:5173/src/App.vue ，那么拼接出来就是http://127.0.0.1:5173/src/1.jpg
• import.meta.url：获取当前模块的路径，比如在src/App.vue中，就是http://127.0.0.1:5173/src/App.vue。

所以最后的new URL().href 就是真正的图片资源地址，自己打印一下new URL(url, baseUrl) 和import.meta.url 就容易明白了。

这里给大伙儿画张图，便于理解。

优雅的解决方案

上面的方案可行，但不够优雅。试想，如果有很多文件都需要动态绑定静态图片资源，那岂不是每个.vue文件都要封装一次getAssetImage() 函数？所以下面介绍一种优雅的封装方案。

封装的主要问题是如何自动获取.vue文件的import.meta.url ，就可以不必每次调用都携带import.meta.url。

核心思路是通过抛出错误获取函数调用栈，从而获得函数调用者文件（或者说模块）的路径，再通过正则表达式提取出路径信息，把import.meta.url替换掉，就能实现，只传图片相对路径这一个参数，得到图片的完整路径的效果。

直接上代码：

• JavaScript版本

// src/utils/common.js

export default {
    getAssetImage(imgSrc, baseUrl) {
        // console.log('baseUrl', baseUrl);
        // console.log('new URL(imgSrc, baseUrl).href', new URL(imgSrc, baseUrl).href);
        // console.log('import.meta.url', import.meta.url);
        // console.log('new URL(imgSrc, import.meta.url).href', new URL(imgSrc, import.meta.url).href);

        // 正则匹配函数调用者文件的路径
        const regExp1 = /at Proxy.getAssetImage \((.+)\)/g;
        // 正则命中目标
        let target;
        try {
            // 抛出错误，获取函数调用栈信息
            throw new Error();
        } catch (err) {
            // 匹配函数调用者文件的路径
            target = regExp1.exec(err?.stack);
            // console.log('err.stack', err?.stack);
            // console.log(target?.[1]);
        }

        if (target?.[1]) {
            // 用户没有传入第二个参数，就使用自动获取的路径
            baseUrl = baseUrl || target?.[1];
        }

        if (!baseUrl) {
            // 用户没有传入第二个参数，且获取函数调用者文件的路径失败
            throw new Error('请传入第二个参数 import.meta.url');
        }
        // 返回处理后的资源路径
        return new URL(imgSrc, baseUrl).href;
    }
}

• TypeScript版本

// src/utils/common.ts

export default {
    getAssetImage(imgSrc: string, baseUrl: string) {
        // console.log('baseUrl', baseUrl);
        // console.log('new URL(imgSrc, baseUrl).href', new URL(imgSrc, baseUrl).href);
        // console.log('import.meta.url', import.meta.url);
        // console.log('new URL(imgSrc, import.meta.url).href', new URL(imgSrc, import.meta.url).href);

        // 正则匹配函数调用者文件的路径
        const regExp1 = /at Proxy.getAssetImage \((.+)\)/g;
        // 正则命中目标
        let target: RegExpExecArray | null;
        try {
            // 抛出错误，获取函数调用栈信息
            throw new Error();
        } catch (err) {
            // 匹配函数调用者文件的路径
            target = regExp1.exec(err?.stack);
            // console.log('err.stack', err?.stack);
            // console.log(target?.[1]);
        }

        if (target?.[1]) {
            // 用户没有传入第二个参数，就使用自动获取的路径
            baseUrl = baseUrl || target?.[1];
        }

        if (!baseUrl) {
            // 用户没有传入第二个参数，且获取函数调用者文件的路径失败
            throw new Error('请传入第二个参数 import.meta.url');
        }
        // 返回处理后的资源路径
        return new URL(imgSrc, baseUrl).href;
    }
}

• 在.vue文件中使用

// src/App.vue

<template>
    <div>
        <!-- 测试 -->
        <img :src="getAssetImage(img_src)">
        <!-- 可以试试在嵌套组件中使用^_^ -->
    </div>
</template>

<script lang="ts" setup>
import { ref } from 'vue';
import common from '@/utils/common.ts';

const img_src = ref('./1.jpg');

// const getAssetImage = img_src => common.getAssetImage(img_src, import.meta.url);
// 可以省略第二个参数import.meta.url，函数内部会自动获取函数的调用路径。
const getAssetImage = img_src => common.getAssetImage(img_src);

// 常规写法
// function getAssetImage(img_src) {
//   return common.getAssetImage(img_src);
// }
</script>

the End……