VSCode不识别.html里的{{ name }}和{% for %}，需将语言模式设为jinja-html并安装JinjaHTML扩展；若想全局生效，须在settings.json中配置files.associations关联.html等后缀到jinja-html。
VSCode不识别.html里的{{ name }}和{% for %}？先改语言模式
VSCode 默认把 .html 当纯 HTML 处理，{{}} 和 {% 被当成非法结构或未闭合标签，既无高亮也无补全。这不是插件没装，是编辑器根本没启用 Jinja2 语言服务。
操作路径很直接：
- 打开任意
index.html模板文件 → 点击右下角语言模式（显示“HTML”）→ 输入jinja-html→ 选择它（不是jinja，也不是jinja2） - 若想一劳永逸，在
settings.json中加这一行："files.associations": {"*.html": "jinja-html", "*.jinja": "jinja-html", "*.jinja2": "jinja-html"} - 装错扩展会导致失效：必须用
JinjaHTML by Samuel Colvin（ID: samuelcolvin.jinjahtml），别选名字带 “BetterJinja” 或 “Jinja” 单字的旧版
为什么装了插件还是没补全？检查两个关键开关
JinjaHTML 插件提供语法高亮和基础片段，但不会自动补全 Python 传入的变量（比如 render_template("page.html", user=current_user) 中的 user.name）。它只做语法层补全，不是运行时上下文感知。
确保这两处开启：
-
"editor.quickSuggestions": {"other": true, "strings": false, "comments": false}在settings.json中全局生效 -
jinja.suggestSnippets在 JinjaHTML 扩展设置里勾选（默认开，但多人反馈升级后被重置） - 输入
{%后按 Tab 应该弹出for、if、block；输入{{后应提示已声明的变量名（如模板内{% set items = [...] %}，则{{ items.可能补全）
Flask开发服务器改代码不重启？启动方式错了
你保存 app.py 或 templates/ 下的 Jinja 文件，终端没反应、浏览器刷新还是旧内容——大概率是用了 python app.py 启动，绕过了 Werkzeug 的重载机制。
正确做法只有两种：
- 命令行用
flask run --reload（确保FLASK_APP=app.py已设） - VSCode 调试时，
launch.json中必须设"module": "flask"，不能写"program": "app.py"；同时args加上--no-reload（调试时禁用 fork 子进程，否则断点失效） - 多个 HTML 相关插件（如 Auto Rename Tag、Prettier）可能抢夺语言模式控制权；临时禁用它们再试
模板报错只在浏览器里显示？VSCode 不校验 Jinja2 语法
JinjaHTML 和 jinjahtml 插件都不做语法校验：不检查 {% block %} 是否配对、{{ user.email }} 中 user 是否传入、过滤器 |upper 是否拼错。这些错误只有 Flask 渲染时才暴露，错误页会显示具体位置和原因。
所以别依赖 VSCode 报错，要习惯看 Flask 错误页。另外注意：
- 如果用
.html后缀混写 Jinja2 和原生 HTML，jinja-html模式会让所有 HTML 标签补全失效；真要兼顾，得靠 VSCode 原生嵌入式语言支持（手动触发，非自动） -
.jinja2或.jinja后缀更稳妥，VSCode 默认就倾向识别为 Jinja2，且不干扰其他 HTML 文件 - 格式化需额外配 Prettier +
prettier-plugin-jinja，JinjaHTML自身不带格式化能力
