VS Code无法识别Django模板{% block %}标签的问题求助

首先明确：网页直接显示模板标签，核心问题不是VS Code的设置，而是后端框架没有正确处理模板文件；VS Code的语法识别只是编辑器的辅助功能，不影响网页渲染结果。

一、先解决模板不渲染的核心问题 #

1. 确认框架并检查模板路径 #

• 若使用Django：
  • 模板文件必须放在对应app的templates文件夹，或项目根目录的templates文件夹
  • 检查settings.py中INSTALLED_APPS是否包含你的app，TEMPLATES配置的DIRS是否正确指向模板目录
• 若使用Flask（Jinja2模板）：
  • 模板默认放在项目根目录的templates文件夹，也可在初始化Flask app时通过template_folder指定自定义路径

2. 检查视图函数的模板渲染方式 #

禁止直接读取HTML文件内容返回，必须用框架提供的模板渲染函数：

• Django示例：

from django.shortcuts import render

def home(request):
    return render(request, 'base.html')  # 用render函数渲染模板

• Flask示例：

from flask import Flask, render_template

app = Flask(__name__)

@app.route('/home')
def home():
    return render_template('base.html')  # 用render_template渲染

3. 子模板需正确继承母版 #

如果是在子模板中使用{% block %}，必须先通过{% extends 'base.html' %}继承母版文件，比如home.html：

{% extends 'base.html' %}

{% block title %}我的主页{% endblock %}

{% block content %}
  <p>这是主页内容</p>
{% endblock %}

二、解决VS Code识别模板标签的问题（仅编辑器语法高亮） #

如果只是VS Code里模板标签无语法高亮、不被识别，可做以下配置：

1. 安装对应扩展：比如针对Django的Django扩展，针对Jinja2的Jinja扩展
2. 配置文件关联：
   • 打开VS Code设置（快捷键Ctrl+,）
   • 搜索files.associations
   • 添加规则：

     "files.associations": {
       "*.html": "django-html"  # 使用Django模板填这个，Jinja2模板填"jinja-html"
     }
     

内容的提问来源于stack exchange，提问作者xiaoqi