vue引用public文件夹中文件的方法限制

1 官方解释

vite官网解释

2 使用

可以先看最下面结论

在Test.vue组件中测试

2.1 图片文件

方式一（ide正常，页面正常，img标签src属性赋值绝对路径/）：

<template>
  <div class="view"><img src="/moon.png" /></div>
</template>
<script setup lang="ts">
console.log("aaa");
</script>
<style scoped>
img {
  width: 300px;
  height: 300px;
}
</style>

build后：

页面显示：

方式二 （ide警告,页面正常,img标签src属性赋值绝对路径/public）

<template>
  <div class="view"><img src="/public/moon.png" /></div>
</template>
<script setup lang="ts">
console.log("aaa");
</script>
<style scoped>
img {
  width: 300px;
  height: 300px;
}
</style>

ide警告：

build后：

可以看到，这样的方式引用，会把图片文件复制一份，名称追加hash值，放在assets下面，根目录下的moon.png并没有被引用

页面显示：

方式三（ide警告，页面正常，img标签src属性赋值相对路径../../public）：

<template>
  <div class="view"><img src="../../public/moon.png" /></div>
</template>
<script setup lang="ts">
console.log("aaa");
</script>
<style scoped>
img {
  width: 300px;
  height: 300px;
}
</style>

ide警告：

build后：

可以看到，这样的方式引用，会把图片文件复制一份，名称追加hash值，放在assets下面，根目录下的moon.png并没有被引用

页面显示：

方式四（ide正常，页面正常，img标签src属性绑定变量，变量赋值/）：

<template>
  <div class="view">
    <img :src="img" />
  </div>
</template>
<script setup lang="ts">
const img = "/moon.png";

console.log("aaa");
</script>
<style scoped>
img {
  width: 300px;
  height: 300px;
}
</style>

build后：

页面显示：

方式五（ide警告，开发页面正常,生产页面报错，img标签src属性绑定变量，变量赋值/public）：

<template>
  <div class="view"><img :src="img" /></div>
</template>
<script setup lang="ts">
const img = "/public/moon.png";
console.log("aaa");
</script>
<style scoped>
img {
  width: 300px;
  height: 300px;
}
</style>

ide警告：

build后：

页面显示：

上图显示正常是因为在开发环境，存在public路径，但是如果部署服务器，就会找不到图片如下图，因为没有public这个路径，

方式六（ide警告，页面正常，img标签src属性绑定变量，变量赋值../../public）：

<template>
  <div class="view"><img :src="img" /></div>
</template>
<script setup lang="ts">
const img = "../../public/moon.png";
console.log("aaa");
</script>
<style scoped>
img {
  width: 300px;
  height: 300px;
}
</style>

ide警告：

build后：

页面显示：

上图显示正常是因为在开发环境，存在public路径，但是如果部署服务器，就会找不到图片如下图，因为没有public这个路径，

方式七（ide正常，页面正常，import图片，路径为/）：

<template>
  <div class="view"><img :src="img" /></div>
</template>
<script setup lang="ts">
import img from "/moon.png";
console.log("aaa");
</script>
<style scoped>
img {
  width: 300px;
  height: 300px;
}
</style>

build后：

页面显示：

方式八（ide警告，页面正常，import图片，路径为/public）：

<template>
  <div class="view"><img :src="img" /></div>
</template>
<script setup lang="ts">
import img from "/public/moon.png";
console.log("aaa");
</script>
<style scoped>
img {
  width: 300px;
  height: 300px;
}
</style>

ide警告：

build后：

可以看到，这样的方式引用，会把图片文件复制一份，名称追加hash值，，放在assets下面，根目录下的moon.png并没有被引用

页面显示：

方式九（ide警告，页面正常，import图片，路径为../../public）：

<template>
  <div class="view"><img :src="img" /></div>
</template>
<script setup lang="ts">
import img from "../../public/moon.png";
console.log("aaa");
</script>
<style scoped>
img {
  width: 300px;
  height: 300px;
}
</style>

ide警告：

build后：

可以看到，这样的方式引用，会把图片文件复制一份，名称追加hash值，，放在assets下面，根目录下的moon.png并没有被引用

页面显示：

2.2 json文件

方式一（ide报错，页面报错，无法使用，import引入）：

<template>
  {{ data }}
</template>
<script setup lang="ts">
import data from "/data.json";
console.log("aaa", data);
</script>
<style scoped></style>

ide报错：

页面报错：

方式二（页面正常，import引入，增加?url参数）：

<template>
  {{ data }}
</template>
<script setup lang="ts">
import data from "/data.json?url";
console.log("aaa", data);
</script>
<style scoped></style>

build后：

页面显示：

可以看到页面仅仅显示路径，而不是文件内容

方式三（ide警告，页面正常，import引入,路径增加/public）：

<template>
  {{ data }}
</template>
<script setup lang="ts">
import data from "/public/data.json";
console.log("aaa", data);
</script>
<style scoped></style>

ide警告：

"vue-tsc && vite build"命令build报错：

"vite build"命令build后:

可以看到，虽然有警告，但是/public中的json文件，在vue组件中用import { test } from '/public/data.json' 方式引入后还是可以使用的,但是json文件内容已经被引入到当前js中了，实际上删除打包后根目录中的data.json也不会影响

页面正常：

方式四（ide警告，页面正常，import引入,路径增加../../public相对路径）：

<template>
  {{ data }}
</template>
<script setup lang="ts">
import data from "../../public/data.json";
console.log("aaa", data);
</script>
<style scoped></style>

ide警告：

build后:

页面显示：

2.3 js文件

方式一（报错，无法使用，import引入）：

<template>
  {{ test }}
</template>
<script setup lang="ts">
import {test} from "/test.js";
console.log("aaa", test);
</script>
<style scoped></style>

ide报错：

页面报错：

方式二（ide警告，页面正常，import引用，路径加/public，绝对路径）：

<template>
  {{ test }}
</template>
<script setup lang="ts">
import {test} from "/public/test.js";
console.log("aaa", test);
</script>
<style scoped></style>

ide警告：

"vue-tsc && vite build"命令build报错：

"vite build"命令build后: build后：

可以看到，虽然有警告，但是/public中的js文件，在vue组件中用import { test } from '/public/test.js' 方式引入后还是可以使用的，但是js文件内容已经被引入到当前js中了，test.js也不会影响

页面显示：

方式三（ide警告，页面正常，import引用，路径加../../public，相对路径）：

<template>
  {{ test }}
</template>
<script setup lang="ts">
import {test} from "../../public/test.js";
console.log("aaa", test);
</script>
<style scoped></style>

ide警告：

"vue-tsc && vite build"命令build报错：

"vite build"命令build后: build后：

可以看到，虽然有警告，但是/public中的js文件，在vue组件中用import { test } from '../../public/test.js' 方式引入后还是可以使用的，但是js文件内容已经被引入到当前js中了，test.js也不会影响

3 结论

序号	文件类型	引入方式	ide显示	开发页面	build	生产页面	引用指向（/为部署目录）
1	img	img标签src属性赋值绝对路径/	正常	正常	正常	正常	/
2		img标签src属性赋值绝对路径/public	警告	正常	正常	正常	复制图片到/assets/
3		img标签src属性赋值相对路径../../public	警告	正常	正常	正常	复制图片到/assets/
4		img标签src属性绑定变量，变量为/	正常	正常	正常	正常	/
5		img标签src属性绑定变量，变量为/public	警告	正常	正常	报错	/public/
6		img标签src属性绑定变量，变量为../../public	警告	正常	正常	报错	../../public/
7		import img from '/moon.png'	正常	正常	正常	正常	/
8		import img from "/public/moon.png"	警告	正常	正常	正常	复制图片到/assets/
9		import img from "../../public/moon.png"	警告	正常	正常	正常	复制图片到/assets/
10	json	import data from "/data.json"	报错	报错	无法build
11		import data from "/data.json?url"	正常	正常	正常	仅显示路径	/
12		import data from "/public/data.json"	警告	正常	vue-tsc && vite build报错，vite build正常	正常	没有引用，文件内容已经包含到当前js中
13		import data from "../../public/data.json"	警告	正常	正常	正常	没有引用，文件内容已经包含到当前js中
14	js	import {test} from "/test.js"	报错	报错	无法build
15		import {test} from "/public/test.js"	警告	正常	vue-tsc && vite build报错，vite build正常	正常	没有引用，文件内容已经包含到当前js中
16		import {test} from "../../public/test.js"	警告	正常	vue-tsc && vite build报错，vite build正常	正常	没有引用，文件内容已经包含到当前js中

综上：

• 1,4,7是正确用法，
• 5,6,10,14是错误用法，
• 2,3,8,9可以使用，但是图片会被复制到assets文件夹，重命名hash,违背放在/public的初衷，
• 11无法获取文件内容，
• 12,13,15,16可以使用，但是json和js会被复制到assets文件夹，重命名hash,违背放在/public的初衷
• 如果有一个图片/json/js文件，含有大量数据，不会经常变动，如果按照官网解释，放在src中的assets文件夹中，build时候会被打包，并且hash命名，不符合我们本意，如果直接放在/public文件夹，只要在组件中引入，build时，就会自动复制到输出目录的/assets/文件夹中,并且hash命名（图片）或者将其内容打包到引用的js文件中（json,js），不符合我们本意，临时的办法是，在index.html中引入json/js文件,但是这样是全局的