首页不适合用@cache_page装饰器，因其按URL缓存整页，无法区分用户态、登录状态或语言偏好，导致个性化内容（如欢迎语、未读消息、推荐列表）被所有用户共享；而{% cache %}支持以request.user.id等动态变量构建多维缓存键，实现安全、灵活的局部缓存。
首页优化不用全页缓存，模板片段缓存（{% cache %}）更灵活、更安全，尤其适合含用户态、动态侧栏或个性化推荐的首页。
为什么首页不适合用 @cache_page 装饰器
首页通常混合了登录态内容（如欢迎语）、未读消息数、轮播图、热门文章、用户最近行为等。用 @cache_page 会把整个页面按 URL 缓存，导致所有用户看到同一份内容——比如未登录用户看到“欢迎，张三”，或新用户看到老用户的推荐列表。
- 缓存键只含 URL 和查询参数，不感知
request.user、request.session或语言偏好 - 即使加
cache="redis_cache"，也无法解决内容个性化问题 - 一旦启用中间件级整站缓存（
UpdateCacheMiddleware），首页可能完全跳过视图逻辑，连权限校验都绕过了
{% cache %} 的参数组合怎么写才不踩坑
关键在第二、第三参数：缓存键标识 + 动态变量。漏掉变量或写错类型，会导致缓存击穿或误共享。
- 必须显式
{% load cache %}，否则模板直接报Invalid block tag - 第一个参数是超时秒数，支持变量（如
{{ CACHE_TIMEOUT_HEADER }}），但别写成字符串"300"—— Django 会当字面量解析失败 - 第二个参数是缓存键前缀，建议用可读字符串，如
"header_nav"，避免纯数字或空格 - 后续参数是缓存键的“维度变量”，例如
request.user.id、request.LANGUAGE_CODE、site_theme；任意一个变化，就生成新缓存项 - 注意：
None值参与拼接会变成字符串"None"，可能导致键污染；建议提前在视图中转为0或空字符串
示例：
立即学习“Python免费学习笔记（深入）”；
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
{% load cache %}
{% cache 600 "homepage_header" request.user.id request.LANGUAGE_CODE %}
<header>
<h1>Welcome, {{ request.user.get_short_name|default:"Guest" }}</h1>
<p>{{ welcome_message }}</p>
</header>
{% endcache %}
首页常见片段缓存场景与对应 key 设计
首页不是“全缓存”或“不缓存”的二选一，而是按区块粒度拆分。每个区块的缓存策略应独立设计。
-
顶部导航栏：依赖用户角色和语言 → 用
request.user.is_authenticated和request.LANGUAGE_CODE作 key 变量 -
轮播 Banner：后台可编辑，需主动失效 → 固定 key 如
"homepage_banner"，更新时调用cache.delete("homepage_banner") -
热门文章列表：对所有用户一致，但需防雪崩 → 加随机偏移：
{% cache 3600|add:random_offset "trending_posts" %}（random_offset在上下文中传入 0–300） -
用户最近阅读：强用户隔离 → 必须包含
request.user.id，且 timeout 设短（如 120 秒），避免 stale 数据
缓存失效难？别靠“到期自动删”，要主动控制
首页片段缓存最常被忽略的一点：它不会随数据变更自动刷新。比如管理员改了 Banner 图片，缓存仍显示旧图，直到超时。
- 在管理后台保存 Banner 模型后，立刻执行
cache.delete("homepage_banner") - 如果首页多个片段共用同一数据源（如
FeaturedProduct），可用统一前缀批量删除：cache.delete_many([k for k in cache.keys("homepage_*")])（注意 Redis 后端支持，locmem不支持keys()） - 避免用
cache.clear()，它会清空整个缓存池，影响其他页面甚至 session 数据 - 上线前检查
CACHES["default"]["KEY_PREFIX"]是否设置，否则不同环境 key 冲突，本地测试删不掉生产缓存
真正麻烦的从来不是加缓存，而是让缓存“该更新时更新、该隔离时隔离、该清除时清除”。首页越动态，越要放弃“设个 timeout 就完事”的想法。
