django模板中变量用{{ var }}自动转义，需可信内容才用|safe；标签如if/for不支持python语法；static/url需先{% load %}且路径依赖配置；简单格式化用filter，复杂逻辑用simple_tag。
怎么在 Django 模板里显示后端传来的变量
直接用 {{ variable_name }}，Django 会自动做 HTML 转义。比如后端 render(request, 'page.html', {'title': 'Hello & World'})，模板里写 {{ title }} 渲染出来是 Hello & World，不是原始的 & 符号。
常见错误现象：页面上看到 <script>alert(1)</script> 被原样打印，而不是执行——这是正常行为，不是 bug；真要不转义得用 {{ content|safe }}，但必须确保内容可信，否则有 XSS 风险。
- 变量名不能含空格或特殊符号，只支持字母、数字、下划线，且不能以数字开头
- 支持点号链式访问：
{{ user.profile.bio }}等价于 Python 的user.profile.bio，任一环节为None或不存在就静默返回空字符串 - 列表索引用点号加数字：
{{ items.0 }}，不是{{ items[0] }}
if/for 标签怎么写才不报错
Django 模板里的 {% if %} 和 {% for %} 是标签，不是 Python 语法，不支持表达式运算、函数调用、赋值，只支持有限的比较和逻辑操作符。
使用场景：判断用户是否登录、循环渲染文章列表、按状态区分按钮文案。
-
{% if user.is_authenticated %}✅；{% if user.is_authenticated() %}❌（不能加括号调用） -
{% if a == b and c > 0 %}✅；{% if a in b %}❌（不支持in，改用{% if b|default:''|add:'x'|contains:a %}太绕，建议逻辑提前放到上下文） -
{% for item in items %}✅；{% for i in 1..10 %}❌（没有 range 支持，需后端传range(10)或用forloop.counter） - 记得配对闭合：
{% endif %}、{% endfor %}，漏掉会报Invalid block tag
为什么 static 和 url 标签总拼错路径
{% load static %} 和 {% url 'name' %} 不是变量，是模板标签，必须先 {% load %} 才能用，且路径解析依赖配置，不是文件系统直读。
常见错误现象：GET /static/css/app.css 404，但文件明明在 static/css/app.css；或者 NoReverseMatch 错误。
-
{% static 'css/app.css' %}输出的是settings.STATIC_URL + 'css/app.css'，默认是/static/，所以最终 URL 是/static/css/app.css，不是./css/app.css -
{% url 'blog:detail' pk=123 %}中的'blog:detail'必须和urls.py里path('post/<pk>/', ..., name='detail')</pk>的name完全一致，包括命名空间（如blog:） -
STATICFILES_DIRS和STATIC_ROOT混用会导致 collectstatic 后找不到文件，开发时优先确认DEBUG=True且django.contrib.staticfiles在INSTALLED_APPS里
filter 和 simple_tag 怎么选
简单格式化用内置 filter（如 {{ dt|date:'Y-m-d' }}），复杂逻辑或需要多个参数、调用函数，就该写 @register.simple_tag，别硬塞进 filter 里。
性能影响：filter 是单参数为主，执行快；simple_tag 可带任意参数，但每次调用都会执行 Python 函数，频繁渲染大列表时要注意。
- filter 不能修改原始值，只能返回新值；
{{ value|add:'5' }}返回字符串相加结果，不是数值加法 - simple_tag 默认不自动转义，返回 HTML 字符串需手动加
mark_safe()，否则会被二次转义 - 自定义 filter 必须注册到
templatetags/下的模块，并在模板顶部{% load my_filters %}，名字冲突不会报错，但后者覆盖前者
最常被忽略的是：template tag 的 Python 文件必须有 __init__.py，且模块名不能和已有内置 filter 重名（比如叫 url.py 就会覆盖 {% url %} 标签）。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
