一、基础层面的体积优化核心技巧

1.1 自动清理没用到的代码

很多小伙伴打包时会发现,明明只用到了某个工具的单个方法,结果打包文件却包含了整个工具库,这就是冗余代码没被清理的问题。Vite基于Rollup打包,自带的代码清理功能(业内叫tree-shaking),只要用ES模块的导入导出规则,就能自动把没用到的代码删掉。 比如之前全量导入lodash的错误示例,会把整个库打包进去:

// 错误示例:导入整个lodash,包含所有方法,体积大
import _ from 'lodash';
const debouncedSearch = _.debounce(handleSearch, 300);

改成按需导入单个方法的正确示例,只会加载需要的功能,体积大幅缩小:

// 正确示例:只导入lodash的防抖函数,不会打包整个库
import debounce from 'lodash-es/debounce';
const debouncedSearch = debounce(handleSearch, 300);

注意要装lodash的ES版本(lodash-es),普通lodash不支持按需导入。

1.2 图片资源的轻量化处理

图片是体积的主要来源,通过压缩和格式转换能快速减体积。Vite可以搭配vite-plugin-image-optimizer插件,自动把JPG/PNG转成体积更小的WebP,同时压缩质量不影响视觉效果。 先安装插件:

# 安装图片压缩插件,生产环境用
npm install vite-plugin-image-optimizer -D

再修改vite.config.js的配置,开启图片压缩和格式转换:

import { defineConfig } from 'vite';
import imageOptimizer from 'vite-plugin-image-optimizer';

export default defineConfig({
  plugins: [
    imageOptimizer({
      // 处理所有常用图片格式
      test: /\.(png|jpe?g|gif|svg)$/i,
      // 转成WebP格式,适配现代浏览器,旧浏览器自动兼容原格式
      webp: { quality: 80 },
      // 压缩PNG,平衡体积和画质
      png: { quality: [0.6, 0.8] },
      // 压缩JPEG
      jpeg: { quality: 80 },
    })
  ],
  build: {
    // 压缩JS代码,进一步减小整体体积
    minify: 'terser',
  }
});

这里WebP的兼容性很好,大部分现代浏览器都支持,能减30%左右的图片体积,是性价比很高的操作。

1.3 代码拆分:避免所有代码打包成一个大文件

单页应用如果把所有代码打包成一个JS文件,用户打开页面时要等整个文件加载完才能显示,很容易卡顿。Vite默认支持代码拆分,但手动调整规则能让拆分更合理,最常用的是按路由拆分。 之前把所有路由组件全量导入的错误示例:

// 错误示例:把所有路由代码打包进主文件,首屏加载慢
import Home from './views/Home.vue';
import User from './views/User.vue';
import Product from './views/Product.vue';

const routes = [
  { path: '/', component: Home },
  { path: '/user', component: User },
  { path: '/product', component: Product },
];

改成动态导入的正确示例,Vite会自动把每个路由的代码拆成单独的小文件,用户访问到对应路由时才加载:

// 正确示例:动态导入,每个路由生成独立代码块,按需加载
const routes = [
  { path: '/', component: () => import('./views/Home.vue') },
  { path: '/user', component: () => import('./views/User.vue') },
  { path: '/product', component: () => import('./views/Product.vue') },
];

这样打包后主文件体积会小很多,首屏加载速度明显提升。

二、架构层面的体积调整方法

如果基础技巧的效果不够,需要从项目结构上调整,比如把大依赖抽离,或者拆分非核心功能。

2.1 第三方依赖用CDN外部引入

如果项目用了Vue、ECharts这类大的通用库,把它们从打包里去掉,用CDN引入,能大幅减小主包体积。以Vue 3为例,修改vite.config.js配置外部依赖:

import { defineConfig } from 'vite';

export default defineConfig({
  build: {
    rollupOptions: {
      // 把Vue设置为外部依赖,不打包进代码
      external: 'vue',
      output: {
        // 打包后对应CDN的全局变量名,避免运行时出错
        globals: { vue: 'Vue' }
      }
    }
  }
});

然后在public/index.html的head里加入CDN链接:

<!-- 生产环境用Vue的生产版CDN,体积小,性能好 -->
<script src="https://cdn.jsdelivr.net/npm/vue@3.3.4/dist/vue.global.prod.js"></script>

注意要确保CDN版本和项目里的依赖版本一致,不然会出现兼容性问题。

2.2 非核心功能做动态拆分

如果项目有非首屏的功能,比如帮助中心、设置页、弹窗组件等,可以做成动态加载的模块,用户触发时才加载,不会占用主包体积。比如做帮助中心的动态组件:

// 定义动态导入的帮助中心组件,不会打包进主包
const HelpCenter = () => import('./components/HelpCenter.vue');

// 按钮点击事件里加载组件
const openHelp = async () => {
  // 加载并渲染组件
  const { default: HelpComponent } = await HelpCenter();
  document.body.appendChild(HelpComponent);
};

这样非核心功能的代码只有用户需要时才会加载,进一步缩减主包体积。

三、应用场景与注意事项

3.1 适用场景

这些方法适合以下情况:

  1. 生产包体积超过100kb,页面加载慢,尤其是移动端用户;
  2. 用到了lodash、ECharts、Element Plus这类大依赖,但只用到部分功能;
  3. 单页应用首屏加载时间超过2秒,首次内容绘制(FCP)不符合性能要求;
  4. 用户反馈页面切换路由时卡顿,加载等待时间长。

3.2 注意事项

  1. 不要过度拆分代码:如果组件很小(比如几百字节),拆分后会增加HTTP请求次数,得不偿失,按路由拆分是最合适的粒度;
  2. 图片压缩要平衡画质:如果压太低会模糊,WebP质量设70-85,PNG设0.5-0.7,既能减体积又不影响体验;
  3. 按需导入依赖要查文档:有些库(比如Element Plus)的按需导入需要额外配置插件,不然会报错,要提前确认;
  4. 外部依赖要考虑兼容性:如果项目需要兼容旧浏览器(如IE11),要确保CDN的库支持旧环境,不然用户会看到错误。

四、总结

优化Vite生产构建体积不需要复杂的操作,从清理冗余代码、压缩资源这些基础操作入手,再配合代码拆分、外部依赖调整这些架构层面的方法,一步步就能把包体积大幅缩小。可以用rollup-plugin-visualizer插件生成打包体积的可视化报告,找到占体积大的部分再针对性优化,就能快速提升页面加载速度,给用户更好的体验。