vite.config.js 中 assetsInlineLimit 怎么配置
在 vite 项目中,通过修改根目录下的 vite.config.js 文件,在 build 配置项下设置 assetsinlinelimit 即可控制资源内联。该参数接受一个整数(单位字节),当静态资源的体积小于此阈值时,vite 会将其转换为 base64 字符串直接嵌入代码;若大于此值,则保持独立文件引用。默认值为 4096 字节(4kb)。

import { defineConfig } from 'vite';
export default defineConfig({
build: {
assetsInlineLimit: 8192 // 设置为 8KB
}
});
上述配置将内联阈值提升至 8KB。这意味着小于 8KB 的图片或字体将被内联,而超过 8KB 的资源仍会被打包为单独的文件。开发者可根据项目对 HTTP 请求数量的敏感度调整此数值。
内联与独立引用的实际效果对比
配置生效后,Vite 会根据文件大小决定输出形式。小文件被内联会增加 JS 包体积但减少网络请求,大文件独立引用则利于浏览器缓存和并行下载。我们可以通过一个简单的 HTML 页面引入不同大小的图片来观察这一行为。

使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
<meta charset="UTF-8"><title>Asset Test</title>
@@##@@
@@##@@
<script type="module" src="/main.js"></script>
假设 small.png 为 2KB,large.png 为 10KB。在 assetsInlineLimit 设为 8KB 的情况下,构建后 small.png 的引用将变为类似 data:image/png;base64,... 的内联数据 URI,而 large.png 仍将保留为 /assets/large-xxx.png 的外部链接。这种差异直接影响最终 HTML 的大小和网络请求数。
基于特定输入条件的内联结果验证
为了验证配置是否生效,我们可以创建一个具体的测试用例。创建一个名为 test.html 的文件,其中包含两个不同大小的占位图片。运行 vite build 后,检查生成的 dist/index.html 文件。如果配置正确,小图片的 src 属性应包含长串的 Base64 编码,而大图片的 src 属性应指向外部资产路径。此外,可以通过查看控制台输出的构建日志,确认哪些资源被标记为 "inlined" 或 "copied",从而精确判断阈值触发的边界情况。


Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










