Vite构建中文件哈希缓存策略的核心是生成带内容哈希的静态资源文件名并配合服务端Cache-Control头实现长期缓存与自动更新;默认启用contenthash,可通过build.rollupOptions.output自定义路径与哈希长度,HTML需由Vite自动注入哈希路径,服务端须对哈希资源设max-age=31536000、对index.html设no-cache。

Vite 构建中配置文件哈希缓存策略,核心是让静态资源(JS、CSS、图片等)生成带内容哈希的文件名,并配合服务端合适的 Cache-Control 响应头,实现“长期缓存 + 自动更新”。它不是靠清浏览器缓存,而是让浏览器自然加载新文件。
启用内容哈希命名(默认已开启)
Vite 2.0+ 在生产构建(vite build)时,默认就为所有产出资源添加基于内容的哈希(contenthash),无需额外插件。例如:
assets/index.e9a2f3b4.jsassets/style.7c8d1a5f.cssassets/logo.b2f9e0a1.png
只要文件内容变化,哈希值就会变,浏览器会当作全新资源请求。
自定义哈希输出路径(按需调整)
若需控制目录结构或哈希长度,可在 vite.config.ts 中配置 build.rollupOptions.output:
-
entryFileNames:入口 JS 文件命名,如assets/js/[name].[hash:8].js -
chunkFileNames:异步 chunk 命名,如assets/js/chunk-[hash:8].js -
assetFileNames:图片/字体等静态资源,如assets/media/[name].[hash:8].[ext]
注意:[hash] 在 Vite 中默认指 contenthash;用 [hash:8] 可截取前 8 位,更简洁。
确保 HTML 正确引用带哈希的资源
Vite 内置的 HTML 处理机制会自动把 index.html 中的 <script></script> 和 标签替换成实际带哈希的路径。前提是:
-
index.html必须放在项目根目录(非public/) - 不要手动写死路径,比如
<script src="main.js"></script>—— 这样会绕过哈希注入 - 若使用多页应用或多入口,需在
build.rollupOptions.input中显式声明 HTML 入口
服务端配合设置 Cache-Control
前端生成哈希只是第一步,服务端必须正确响应缓存头才能生效:
- 对带哈希的静态资源(
.js、.css、.png等):返回Cache-Control: public, max-age=31536000(1年) - 对
index.html:必须设为no-cache或max-age=0, must-revalidate,避免 HTML 缓存导致引用旧资源
常见服务器配置示例:
- Nginx:
location ~* \.(js|css|png|jpg|gif)$ { add_header Cache-Control "public, max-age=31536000"; } - Cloudflare / CDN:可针对
/assets/*路径设置长期缓存规则
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











