VSCode默认不识别.html文件为Jinja模板，需手动设语言模式为“Jinja-HTML”或在settings.json中配置"files.associations": {"*.html": "jinja-html"}，并确保使用支持插件（如JinjaHTML）且无扩展冲突。
Jinja2模板文件不识别为Jinja语法
VSCode默认不把.html文件当Jinja模板处理，哪怕里面写了{{ name }}或{% for item in items %}，也会当成纯HTML——结果就是变量、循环、条件块全无高亮，补全失效，还容易误判语法错误。
常见现象：打开index.html，右下角语言模式显示“HTML”，不是“Jinja”或“Jinja-HTML”；输入{%后没自动补全endblock等结束标签。
- 确认文件扩展名是否在Jinja插件支持范围内：优先用
.jinja或.jinja2；若必须用.html，需手动关联语言模式 - 打开模板文件 → 点击右下角语言模式（如“HTML”）→ 输入
jinja→ 选择Jinja-HTML（不是“Jinja”单选，后者不支持HTML嵌套） - 在
settings.json中加配置，一劳永逸：{"files.associations": {"*.html": "jinja-html","*.jinja": "jinja-html","*.jinja2": "jinja-html"}} - 装了多个HTML相关插件（比如Auto Rename Tag、Prettier）时，可能抢夺语言模式控制权；临时禁用它们再试
Flask开发服务器改代码后不自动重启
你保存app.py或templates/下的Jinja文件，终端里没反应，浏览器刷新还是旧内容——这不是代码没生效，是Werkzeug的重载机制被绕过或压根没启用。
根本原因通常是启动方式不对：python app.py直接运行会跳过Flask CLI，flask run才走标准流程；而VSCode调试器若没配对，也会让--reload失效。
- 确保用
flask run启动，不是python app.py；检查launch.json里是"module": "flask"，不是"program" -
FLASK_DEBUG=1比FLASK_ENV=development更可靠（后者在Flask 2.3+已弃用），且必须通过envFile或env字段传入，不能靠终端export - 修改Jinja模板时，默认
--reload只监听.py文件；加--extra-files参数才能热更模板：["run", "--extra-files=templates/,static/"] - Windows上路径分隔符写错（比如用了
\但JSON不认）会导致--extra-files静默失败；统一用正斜杠/
断点打在Jinja模板里没效果
Jinja模板本身不能设断点——VSCode不支持在.html或.jinja里点红点。所谓“模板断点”实际是指：在渲染该模板的视图函数内部设断点，然后观察render_template("xxx.html", ...)调用前后变量值。
但很多人误以为改了模板就得在模板里打断点，结果调试时完全停不住，怀疑是环境问题。
- 断点只能打在Python文件里：路由函数、
render_template调用前、上下文处理器中 - 想查模板里某个变量怎么来的？在视图函数里
print(context_dict)或用pprint输出传入render_template的参数字典 - 模板语法错误（比如
{% endif %}漏写）不会触发断点，而是返回500错误；此时看终端报错堆栈，定位到render_template那一行即可 - 如果连视图函数断点都不停，先确认
justMyCode设为true（避免卡在Werkzeug源码里），且没勾选“仅限当前文件”调试过滤
模板修改后浏览器仍缓存旧内容
这不是Flask的问题，是浏览器把text/html响应缓存了。尤其当你没改Python代码、只动了Jinja，flask run --reload确实重启了，但浏览器发的是带If-None-Match的条件请求，服务端直接回304。
最典型的症状：终端显示127.0.0.1 - - [16/Apr/2026 23:38:00] "GET / HTTP/1.1" 304 -，但页面没变。
- 开发阶段，在Chrome/Firefox里按
Ctrl+Shift+R（硬刷新）或Ctrl+F5，跳过缓存强制重载 - VSCode调试时，可在
app.py开头加：app.config['SEND_FILE_MAX_AGE_DEFAULT'] = 0
，让静态文件和模板响应禁用缓存 - 如果用了Nginx或前端代理，它也可能缓存；先关掉代理直连
http://localhost:5000确认问题来源 - 某些浏览器扩展（如广告屏蔽器）会注入脚本并干扰响应头；隐身窗口测试可快速排除
Jinja高亮和热重载看着是两件事，其实共享同一个底层前提：VSCode必须正确识别项目为Flask应用，并让所有文件路径落在Python模块搜索路径内。一旦templates/目录没被当成包的一部分，--extra-files就找不到它，Jinja插件也读不到上下文里的render_template调用链。
