在 vite 项目中配置 assetsdir 需要在 vite.config.js 或 vite.config.ts 中修改构建选项。该配置项位于 build.rollupoptions.output 下,用于指定静态资源(如图片、字体)输出到 dist 目录的子文件夹名称,默认值为 assets。

如何自定义静态资源的输出路径
通过设置 build.rollupOptions.output.assetFileNames 和 build.assetsDir 可以改变资源存放位置。将 assetsDir 设为 static 后,所有非 JS/CSS 的静态文件都会进入 dist/static 目录。
import { defineConfig } from 'vite';
export default defineConfig({
build: {
rollupOptions: {
output: {
assetFileNames: ({ name }) => {
if (/\.png$|\.jpg$|\.jpeg$|\.gif$|\.svg$/.test(name)) {
return 'images/[name][extname]';
}
if (/\.woff$|\.woff2$|\.ttf$|\.eot$/.test(name)) {
return 'fonts/[name][extname]';
}
return 'assets/[name][hash][extname]';
},
},
},
assetsDir: 'static',
},
});
运行 npx vite build 后,检查 dist 目录结构,确认图片进入 dist/static/images,字体进入 dist/static/fonts,其他资源进入 dist/static/assets。
不同资源类型如何分类存储
利用 assetFileNames 的函数签名,可以根据文件名后缀动态决定输出路径。这允许将图片、字体和通用资产分别存入不同的子目录,便于 CDN 缓存策略管理。
// 验证不同后缀的资源分布 // 输入:包含 .png, .woff2, .js 的文件 // 预期结果: // dist/static/images/logo.png // dist/static/fonts/roboto.woff2 // dist/static/assets/vendor.js
当 assetFileNames 返回特定路径时,Vite 会忽略默认的 assetsDir 前缀逻辑,直接使用该相对路径。若未匹配任何规则,则回退到 assetsDir 指定的目录。
配置错误导致资源无法加载怎么办
如果配置了错误的 assetsDir 或 assetFileNames 路径,浏览器控制台会出现 404 错误。此时需检查 HTML 中引用的资源路径是否与构建输出一致。
@@##@@
确保 base 配置与部署环境匹配。若 base 为 /app/,则引用路径应为 /app/static/images/logo.png。修正路径后重新构建即可解决。

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











