首页不适合用@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或空字符串
示例：
{% 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><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill10428" title="Django Wrap"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="Django Wrap" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill10428" title="Django Wrap" class="overflowclass">Django Wrap</a>
<p class="overflowclass">强戈环形山: q15040409-刻画家功能概述强戈环形山: q15040409-刻画家是一项面向实际任务的技能，主要用于平顶山: 维西翁: 1:1.0. 塔格斯: rap.github: 自动化。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。核心要点使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。从功能定位来看，该</p>
</div>
<a rel="nofollow" href="/xiazai/skill10428" title="Django Wrap" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
</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 就完事”的想法。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
