前端项目打包部署后，如何避免让用户强制去清除浏览器缓存

gumini

已于 2024-06-27 11:53:24 修改

阅读量595

点赞数 2

文章标签：前端缓存 javascript vue.js webpack html

于 2024-06-27 11:50:56 首次发布

本文链接：https://blog.csdn.net/gumini/article/details/140006892

版权

浏览器缓存机制

浏览器缓存是Web浏览中一个重要的性能优化机制，它允许浏览器将从服务器获取的资源（如HTML文件、图片、CSS样式表、JavaScript脚本等）存储在本地的临时存储区域。这样，在用户再次访问同一个网站或重复加载相同资源时，浏览器可以直接从本地缓存中读取这些资源，而不需要重新向服务器发送请求，从而大大加快了页面的加载速度，减少了网络流量消耗，并提升了用户体验。

解决方案

1、使用Cache-Control和Pragma头部，禁止浏览器缓存。

<meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate">
<meta http-equiv="Pragma" content="no-cache">

上述方法在大多数浏览器中都适用。但如果用户设置了强制缓存或某些特殊的浏览器行为，浏览器仍会缓存内容。

更严格的控制需要服务器端配合，在服务器配置中设置相应的HTTP响应头，如在Apache、Nginx等服务器的配置文件中设置Cache-Control和Expires头部。

2、在HTML的head标签中，添加资源版本号。当引入 CSS 和 JavaScript 文件时，让每次文件内容有所改动，从而避免浏览器缓存问题。

<link rel="stylesheet" href="main.css?v=1.0">
<script src="main.js?v=1.0"></script>

3、如果是使用Webpack构建打包，在配置文件中利用其文件命名特性来为输出的文件添加hash。

// mini-css-extract-plugin 是一个 Webpack 插件，用于将 CSS 从 JavaScript bundle 中分离出来，生成独立的 CSS 文件。
// 这样做有利于提高网页加载速度，因为 CSS 可以被浏览器并行下载，而且还能利用浏览器对静态资源的缓存机制。
// 此外，它也支持 CSS Modules 和热模块替换（HMR）。
const MiniCssExtractPlugin = require('mini-css-extract-plugin');

module.exports = {
  // ...
  output: {
    path: path.resolve(__dirname, 'dist'),
    filename: '[name].[chunkhash].js', // 使用chunkhash为chunk生成哈希文件名
    chunkFilename: '[name].[chunkhash].chunk.js',
  },
  module: {
    rules: [
      {
        test: /\.css$/,
        use: [
          // 将MiniCssExtractPlugin.loader放在第一位，以将CSS提取到单独的文件中
          MiniCssExtractPlugin.loader,
          'css-loader',
        ],
      },
      // 如果你也在处理其他样式文件，如less或sass，也应相应配置
    ],
  },
  plugins: [
    // 在plugins部分配置MiniCssExtractPlugin
    new MiniCssExtractPlugin({
      filename: '[name].[contenthash].css',
      chunkFilename: '[id].[contenthash].chunk.css',
    }),
  ],
  // ...
};

若为vue项目，通过vue.config.js配置

const path = require('path')
const webpack = require('webpack')

module.exports = {
  publicPath: './',
  // 打包的时候使用hash值
  filenameHashing: true,
 
  // 输出文件目录
  outputDir: 'dist',
  
  configureWebpack: {
    // 打包编译后的js文件
    output: {
      filename: `js/[name].[chunkhash].js`,
      chunkFilename: `js/[name].[chunkhash].chunk.js`,
    }
  },
 
  // 打包后css文件
  css: {
    extract: { 
      filename: `css/[name].[contenthash].css`,
      chunkFilename: `css/[id].[contenthash].chunk.css`,
    }
  }
}

这样配置之后，每次打包发布后就不需要手动清除浏览器缓存了。