如何在Django中高效添加静态文件版本号？现有方案需手动更新

方法一：基于文件哈希的自动版本标签（开发/生产通用） #

无需手动维护版本号，通过计算静态文件的内容哈希值作为版本标识，文件修改后哈希自动更新，彻底解决手动更新的麻烦。

实现步骤 #

1. 编写通用模板标签：

# 在你的模板标签文件中（比如 templatetags/static_version.py）
import hashlib
import os
from django import template
from django.conf import settings

register = template.Library()

@register.simple_tag
def static_version(path):
    # 根据环境拼接静态文件绝对路径
    if settings.DEBUG:
        file_path = os.path.join(settings.STATICFILES_DIRS[0], path)
    else:
        file_path = os.path.join(settings.STATIC_ROOT, path)
    
    try:
        # 读取文件内容计算MD5哈希，取前8位作为短版本号
        with open(file_path, 'rb') as f:
            file_hash = hashlib.md5(f.read()).hexdigest()[:8]
        return file_hash
    except FileNotFoundError:
        # 文件不存在时返回空值，避免页面报错
        return ''

2. 模板中使用：

{% load static %} 
{% load static_version %}

<link href="{% static 'css/home/base.css' %}?v={% static_version 'css/home/base.css' %}" rel="stylesheet" type="text/css">

说明 #

• 开发环境下读取STATICFILES_DIRS中的源文件，生产环境读取collectstatic后的STATIC_ROOT目录文件，适配不同环境。
• 哈希值取前8位足够区分文件版本，同时避免URL过长。

方法二：使用Django内置的ManifestStaticFilesStorage（生产环境推荐） #

利用Django原生的静态文件存储类，在收集静态文件时自动给文件名添加内容哈希后缀（比如base.css变成base.abc123def456.css），浏览器会通过文件名变化自动加载最新资源，无需手动处理版本参数。

实现步骤 #

1. 修改settings.py配置：

# settings.py
DEBUG = False  # 生产环境需关闭DEBUG模式
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')  # 收集静态文件的目标目录
STATICFILES_STORAGE = 'django.contrib.staticfiles.storage.ManifestStaticFilesStorage'

2. 运行收集静态文件命令：

python manage.py collectstatic

3. 模板中正常使用{% static %}标签：

{% load static %}

<link href="{% static 'css/home/base.css' %}" rel="stylesheet" type="text/css">

说明 #

• 该方法适合生产环境，开发环境频繁修改文件时，哈希生成会降低效率，建议开发阶段用方法一或直接禁用浏览器缓存。
• 文件名哈希完全由Django自动维护，彻底消除手动更新版本号的操作。

内容的提问来源于stack exchange，提问作者Manoj Kamble