Python开发阶段后台管理系统，如何检测JS内容变动并自动修改文件名？

这个问题在Web开发中很常见，主要是为了实现前端静态资源的版本化管理，避免浏览器缓存导致更新后用户看不到最新代码。

核心思路是：在构建阶段，通过计算JS文件的哈希值（如MD5或SHA-256）并将其附加到文件名中，同时自动更新HTML模板中的引用路径。

这里提供一个基于Python的简单实现方案，使用hashlib计算文件哈希，并结合os和re模块进行文件操作和内容替换。

import hashlib
import os
import re
import glob

def generate_file_hash(filepath):
    """计算文件的MD5哈希值（取前8位）"""
    hash_md5 = hashlib.md5()
    with open(filepath, "rb") as f:
        for chunk in iter(lambda: f.read(4096), b""):
            hash_md5.update(chunk)
    return hash_md5.hexdigest()[:8]

def update_js_references(html_file, js_mapping):
    """更新HTML文件中的JS引用"""
    with open(html_file, 'r', encoding='utf-8') as f:
        content = f.read()
    
    for old_name, new_name in js_mapping.items():
        # 使用正则匹配替换script标签中的src属性
        pattern = rf'src=["\'](.*?{re.escape(old_name)})["\']'
        replacement = f'src="static/js/{new_name}"'
        content = re.sub(pattern, replacement, content)
    
    with open(html_file, 'w', encoding='utf-8') as f:
        f.write(content)

def main():
    # 配置路径
    js_dir = "static/js"
    html_file = "templates/index.html"
    
    # 获取所有JS文件
    js_files = glob.glob(os.path.join(js_dir, "*.js"))
    js_mapping = {}
    
    for js_file in js_files:
        # 计算哈希并生成新文件名
        file_hash = generate_file_hash(js_file)
        base_name = os.path.basename(js_file)
        name_without_ext, ext = os.path.splitext(base_name)
        new_name = f"{name_without_ext}.{file_hash}{ext}"
        
        # 重命名文件
        new_path = os.path.join(js_dir, new_name)
        os.rename(js_file, new_path)
        js_mapping[base_name] = new_name
        print(f"Renamed: {base_name} -> {new_name}")
    
    # 更新HTML引用
    if js_mapping:
        update_js_references(html_file, js_mapping)
        print("Updated HTML references")

if __name__ == "__main__":
    main()

关键点说明：

1. 哈希生成：generate_file_hash函数计算JS文件的MD5哈希，取前8位足够区分不同版本。
2. 文件重命名：将原文件名改为原文件名.哈希值.js的格式。
3. 引用更新：update_js_references函数使用正则表达式匹配HTML中对应的<script>标签，并替换src属性。

使用方式：

• 将上述代码保存为version_assets.py
• 根据实际情况修改js_dir和html_file路径
• 在构建或部署脚本中运行此脚本

生产环境建议： 虽然这个方案能解决问题，但在实际项目中，更推荐使用成熟的构建工具：

• Webpack：配合output.filename的[contenthash]占位符
• Vite：内置资源哈希处理
• Django-Compressor或Flask-Assets：专门的静态资源管理扩展

这些工具提供了更完善的功能，如依赖分析、代码压缩、缓存失效等。

一句话总结：用文件哈希重命名JS并同步更新HTML引用，但建议直接用Webpack等成熟构建工具。

mc 牛逼