在 vite 项目中集成图片压缩插件,推荐使用 vite-plugin-imagemin。通过安装该依赖并在 vite.config.js 的 plugins 数组中配置实例,即可在构建时自动将指定目录下的图片转换为更小的体积格式(如 webp、avif)或进行无损/有损压缩。

如何配置基础压缩规则与输出格式
配置基础规则的核心在于实例化插件并传入 imagemin 选项对象。你需要指定要处理的文件类型(如 jpg、png),并选择是否启用格式转换。例如,设置 jpegs 和 pimgs 的 mqs(质量)参数可以控制压缩强度,而 enabled 字段配合 convertTo 可以实现将 PNG 转为 WebP 的功能。

import { defineConfig } from 'vite';
import imagemin from 'vite-plugin-imagemin';
export default defineConfig({
plugins: [
imagemin({
gifsicle: { optimizationLevel: 7 },
optipng: { enabled: true, optimizationLevel: 3 },
mozjpeg: { quality: 75 },
pngquant: { quality: [0.65, 0.90], speed: 4 },
svgo: {
plugins: [
{ removeViewBox: false },
{ removeEmptyAttrs: false }
]
}
})
]
});
上述代码展示了针对 GIF、PNG、JPEG 和 SVG 的具体优化策略。GIF 使用 gifsicle 进行第 7 级优化;PNG 优先使用 pngquant 进行有损压缩(质量 65%-90%),若未启用则回退到 optipng 无损压缩;JPEG 使用 mozjpeg 并将质量设为 75;SVG 使用 svgo 移除不必要的空白但保留 viewBox。运行 vite build 后,控制台会显示各图片的压缩前后大小对比。
如何处理特定目录的图片与排除干扰项
当项目结构复杂时,通常只需压缩 src/assets 或 public 中的图片,而忽略 node_modules 或测试图片。虽然 vite-plugin-imagemin 默认处理所有静态资源,但可以通过结合 Vite 的 build.rollupOptions 或插件内部的过滤逻辑来精准控制。更常见的做法是确保只将需要压缩的图片放在 src/assets 下,因为 Vite 默认只处理该目录下的静态资源引用。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

// vite.config.js 补充配置示例
export default defineConfig({
build: {
rollupOptions: {
output: {
// 确保静态资源被正确打包
assetFileNames: 'assets/[name]-[hash][extname]'
}
}
},
plugins: [
imagemin({
// 仅对 jpg, jpeg, png, gif, svg 生效
test: /\.(jpg|jpeg|png|gif|svg)$/i,
// 其他配置同上
})
]
});
通过 test 正则表达式明确限定文件扩展名,可以避免插件尝试处理非图片文件导致的潜在错误或性能浪费。在实际开发中,建议将大型背景图或图标单独管理,并在构建前检查 dist 目录下的资源大小分布,以验证压缩效果是否符合预期。
压缩后的图片在构建产物中的路径变化是怎样的
经过 vite-plugin-imagemin 处理后,图片的文件名通常会保持不变,除非启用了 convertTo 格式转换功能。如果启用了格式转换(例如 PNG 转 WebP),原文件会被替换为转换后的新文件,且文件名后缀会改变。在构建产物 dist 中,这些图片会被哈希化处理,存入 assets 文件夹,其引用路径由 Vite 的模块解析机制自动更新,开发者无需手动修改 HTML 或 CSS 中的图片路径。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










