templatespanel未显示是因debug_toolbar_panels缺失配置，加载慢则因上下文过大；需启用面板、关闭show_template_context、跳过系统模板并限制缓存大小。
TemplatesPanel 为什么没显示或加载极慢？
模板面板不出现，大概率是 DEBUG_TOOLBAR_PANELS 里漏掉了 'debug_toolbar.panels.templates.TemplatesPanel'；而加载卡顿，几乎总是因为上下文数据过大或嵌套太深——它默认会序列化整个模板上下文，对含大量 QuerySet 或嵌套 dict 的页面尤其明显。
实操建议：
- 确认配置中已显式启用：确保
DEBUG_TOOLBAR_PANELS列表包含'debug_toolbar.panels.templates.TemplatesPanel' - 关闭上下文渲染（关键）：设
DEBUG_TOOLBAR_CONFIG = {"SHOW_TEMPLATE_CONTEXT": False}，避免 JSON 序列化拖垮浏览器 - 跳过系统模板：用
SKIP_TEMPLATE_PREFIXES = ('django/forms/widgets/', 'admin/')过滤掉无关模板，减少采集量 - 限制缓存条目：加
RESULTS_CACHE_SIZE = 10防止内存堆积（默认 25，高并发下易OOM）
怎么看出哪个模板文件拖慢了整页？
TemplatesPanel 会列出所有被渲染的模板，按耗时降序排列。重点看「Render time」列——超过 50ms 的模板值得优先检查；若某个 include 或 extends 模板耗时异常高，说明它内部存在未优化逻辑（比如循环中查数据库、重复计算）。
实操建议：
- 点击模板行右侧的「Context」箭头（即使
SHOW_TEMPLATE_CONTEXT=False，也能看到变量名和类型） - 留意「Template path」是否指向你写的业务模板（如
blog/post_list.html），而非 Django 内置模板 - 对比「# of renders」：同一模板被多次渲染（如列表项中每个 item 都 render 一遍）可能暗示可合并或缓存
为什么点了 TemplatesPanel 却看不到变量值或调用栈？
不是所有变量都默认展开。Django-debug-toolbar 对复杂对象（如 QuerySet、Model 实例）只显示类型和 repr，不会递归展开字段——这是为了防止页面卡死，不是 bug。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
实操建议：
- 在视图中主动精简上下文：用
.values()、.only()或as_dict替代完整 QuerySet 传入模板 - 想查某变量具体值？在模板里临时加
{{ my_var|pprint }}（需加载django.template.defaultfilters.pprint） - 调用栈信息藏在「Context」下的「Origin」字段里，点开能看到是哪个视图或中间件触发的该模板渲染
TemplatesPanel 和 SQLPanel 联动怎么看 N+1？
单看 TemplatesPanel 只能知道“模板慢”，但不知道为什么慢；必须结合 SQLPanel 才能定位根源。典型 N+1 场景是：模板里遍历一个 object_list，每项又调用 item.author.name，导致每次循环都触发一次 SQL 查询。
实操建议：
- 打开 SQLPanel，看「Duplicates」列：如果同一 SQL 出现 20 次，而模板里刚好有个 20 条的 forloop，基本就是 N+1
- 回到 TemplatesPanel，找到对应循环模板，检查是否用了
select_related或prefetch_related - 注意时间对齐：SQLPanel 的总查询时间 + TemplatesPanel 的渲染时间 ≈ 页面总耗时，两者差距大说明瓶颈在 Python 层（如字符串拼接、JSON 序列化）
模板渲染瓶颈最常被忽略的一点：它不只发生在 render() 调用时，也发生在 HttpResponse 构造、中间件处理响应内容等环节。TemplatesPanel 只捕获 template_rendered 信号触发的渲染，对非模板路径（如直接返回 JSON）完全无感——别指望它覆盖全部性能问题。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
