Vite 打包目录结构自定义配置小结

 更新时间:2025年08月29日 10:36:19   作者:没烦恼301  
在Vite工程开发中,默认打包后的dist目录资源常集中在asset目录下,不利于资源管理,本文基于Rollup配置原理,本文就来介绍一下通过Vite配置自定义打包目录结构,感兴趣的可以了解一下

在 Vite 工程开发中,默认打包后的 dist 目录资源常集中在 asset 目录下,不利于资源管理。本文基于 Rollup 配置原理,详细介绍如何通过 Vite 配置自定义打包目录结构,实现 JS、CSS、图片等资源的分类存放。

一、实现原理

Vite 底层依赖 Rollup 进行打包,因此需通过 Vite 的 build.rollupOptions 配置项传递 Rollup 相关参数,核心通过 Rollup 的 output 配置控制资源输出路径:

  • entryFileNames:控制入口 JS 文件的输出路径
  • chunkFileNames:控制分包/懒加载生成的 JS chunk 文件路径
  • assetFileNames:控制非 JS 资源(CSS、图片、SVG 等)的输出路径

二、具体配置步骤

1. 基础配置文件

在项目根目录的 vite.config.js(或 vite.config.ts)中,通过 build.rollupOptions.output 配置资源输出规则:

// vite.config.js
import { defineConfig } from 'vite';

export default defineConfig({
  build: {
    rollupOptions: {
      output: {
        // 1. 入口 JS 文件输出配置
        entryFileNames: 'js/[name].[hash].js', 
        // 2. 分包/懒加载 JS 文件输出配置
        chunkFileNames: 'js/[name].[hash].js', 
        // 3. 非 JS 资源输出配置(通过函数细分类型)
        assetFileNames: (assetInfo) => {
          // 定义图片后缀列表
          const imgExts = ['png', 'jpg', 'jpeg', 'gif', 'svg', 'webp'];
          // 获取资源文件名
          const fileName = assetInfo.name || '';
          
          // 若为 CSS 文件,输出到 css 目录
          if (fileName.endsWith('.css')) {
            return 'css/[name].[hash].[ext]';
          }
          // 若为图片文件,输出到 images 目录
          if (imgExts.some(ext => fileName.endsWith(`.${ext}`))) {
            return 'images/[name].[hash].[ext]';
          }
          // 其他资源默认输出到 asset 目录
          return 'asset/[name].[hash].[ext]';
        }
      }
    }
  }
});

2. 配置说明

(1)JS 资源分离

  • entryFileNames:将项目入口 JS 文件(如 main.js)输出到 dist/js 目录,命名格式为 文件名.哈希值.js(哈希值用于缓存控制)。
  • chunkFileNames:将路由懒加载、代码分割生成的 JS chunk 文件统一输出到 dist/js 目录,与入口 JS 集中管理。

(2)非 JS 资源细分

通过 assetFileNames 函数对资源类型进行判断:

  • CSS 文件:匹配 .css 后缀,输出到 dist/css 目录。
  • 图片资源:匹配 png、jpg、svg等图片后缀,输出到 dist/images目录。
  • 其他资源:未匹配的资源(如字体、视频等)默认输出到 dist/asset 目录。

(3)占位符说明

配置中使用的 Rollup 占位符含义:

  • [name]:资源原始文件名(不含后缀)
  • [hash]:基于文件内容生成的哈希值(用于避免缓存问题)
  • [ext]:资源原始后缀名(含 .,如 .css、.png)

三、打包效果验证

执行 npm run build 打包后,dist 目录结构如下:

dist/
├─ js/                 # 所有 JS 资源
│  ├─ main.xxxx.js     # 入口 JS
│  └─ chunk.xxxx.js    # 分包 JS
├─ css/                # 所有 CSS 资源
│  └─ style.xxxx.css
├─ images/             # 所有图片资源
│  ├─ logo.xxxx.png
│  └─ icon.xxxx.svg
└─ asset/              # 其他资源
   └─ font.xxxx.ttf

四、注意事项

  1. 配置兼容性:确保 Vite 版本 ≥ 2.0,Rollup 配置语法随版本可能略有差异,建议参考对应版本官方文档。
  2. 资源类型扩展:如需添加更多资源类型(如字体 woff2),可在 imgExts 或判断逻辑中扩展。
  3. 哈希值必要性:保留 [hash] 占位符可有效解决浏览器缓存问题,避免线上资源更新后用户无法获取最新内容。

通过上述配置,可实现 Vite 打包目录的精细化管理,提升项目资源组织的清晰度和可维护性。

到此这篇关于Vite 打包目录结构自定义配置小结的文章就介绍到这了,更多相关Vite 打包目录结构配置内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • vue中拆分组件的实战案例

    vue中拆分组件的实战案例

    最近在学vue,试着写个单页应用,在写组件,拆分组件时遇到一些困惑,下面这篇文章主要给大家介绍了关于vue中拆分组件的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2022-12-12
  • 一文带你了解Vue 和 React的区别

    一文带你了解Vue 和 React的区别

    这篇文章主要介绍了Vue和React的区别,毕竟是两个框架,不像两个 API,要说细节上的区别就太多太多了,本文就简单的带大家说说Vue 和 React 的区别,需要的朋友可以参考下
    2023-05-05
  • Vue结合ElementUI实现数据请求和页面跳转功能(最新推荐)

    Vue结合ElementUI实现数据请求和页面跳转功能(最新推荐)

    我们在Proflie.vue实例中,有beforeRouteEnter、beforeRouteLeave两个函数分别是进入路由之前和离开路由之后,我们可以在这两个函数之内进行数据的请求,下面给大家分享Vue结合ElementUI实现数据请求和页面跳转功能,感兴趣的朋友一起看看吧
    2024-05-05
  • Vue中组件之间传值的六种方式(完整版)

    Vue中组件之间传值的六种方式(完整版)

    组件是 vue.js 最强大的功能之一,而组件实例的作用域是相互独立的,这就意味着不同组件之间的数据无法相互引用,针对不同的使用场景,如何选择行之有效的通信方式?这是我们所要探讨的主题,本文总结了 vue 组件间通信的几种方式,需要的朋友可以参考下
    2025-03-03
  • 详解Vue-cli webpack移动端自动化构建rem问题

    详解Vue-cli webpack移动端自动化构建rem问题

    这篇文章主要介绍了详解Vue-cli webpack移动端自动化构建rem问题,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-04-04
  • vue 实现通过vuex 存储值 在不同界面使用

    vue 实现通过vuex 存储值 在不同界面使用

    今天小编就为大家分享一篇vue 实现通过vuex 存储值 在不同界面使用,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-11-11
  • vue使用codemirror的两种用法

    vue使用codemirror的两种用法

    这篇文章主要介绍了在vue里使用codemirror的两种用法,每种方法通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-08-08
  • 基于vue编写一个月饼连连看游戏

    基于vue编写一个月饼连连看游戏

    中秋节快要到啦,我们一起用Vue创建一个简单的连连看游戏,连连看大家一定都玩过吧,通过消除相同的图案来清理棋盘,小编将一步步引导大家完成整个游戏的制作过程,让我们开始吧,一起为中秋节增添一些互动和娱乐
    2023-09-09
  • vue-model实现简易计算器

    vue-model实现简易计算器

    这篇文章主要为大家详细介绍了vue-model实现简易计算器,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-08-08
  • vue如何截取字符串

    vue如何截取字符串

    这篇文章主要介绍了vue如何截取字符串,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-05-05

最新评论