必须手动将.html文件语法设为“HTML (Jinja2)”，因Sublime默认按原生HTML处理，插件仅提供语法定义而不自动启用；全局绑定会破坏非模板HTML的补全，自定义过滤器和宏不提示属正常设计限制。
Flask 模板文件（如 index.html）在 Sublime Text 里默认没有语法提示，不是因为插件没装，而是因为 Flask 本身不提供模板语法高亮——它用的是 Jinja2 引擎，而 Sublime 默认只认原生 HTML。
你看到的 {{ name }}、{% if user %} 灰乎乎没颜色，甚至变量名、过滤器（比如 |safe）不补全，根本原因只有一个：Sublime 没被告诉“这是 Jinja2 模板”，它还在当普通 HTML 解析。
怎么让 .html 文件识别 Jinja2 语法？
HTML (Jinja2) 是目前最稳定、维护活跃的语法包，比老旧的 SublimeJinja 或已停更的 Flask Snippets 更可靠。
- 安装方式：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package，回车后搜HTML (Jinja2)，选中安装 - 安装完不会自动生效——必须手动切换当前文件语法：再按
Ctrl+Shift+P，输入Set Syntax: HTML (Jinja2)，回车 - 如果想让所有
.html文件默认用这个语法：菜单栏View → Syntax → Open all with current extension as… → HTML (Jinja2)
注意：HTML (Jinja2) 不会识别 Flask 特有扩展（如 {% set active = 'home' %} 中的 set 是 Jinja2 原生，但 {% extends "base.html" %} 这类也支持；真正不支持的是 {% load static %} 这种 Django 专属语法，别混用）
为什么装了 Flask Snippets 却没模板补全？
Flask Snippets 插件只补全 Python 侧代码（比如 @app.route、render_template()），它不管 HTML 文件里的模板语法。你在 .py 文件里敲 flask_route 能出路由，在 .html 里敲 if 或 for 是不会触发任何补全的。
要实现模板内补全，得靠语法定义 + 配套插件：
-
HTML (Jinja2)提供基础高亮和括号匹配 - 若需
{{ user|后弹出过滤器列表，得额外装AutoFileName（用于路径补全）或Emmet（写 HTML 结构快），但 Jinja2 变量/过滤器补全本身 Sublime 原生不支持，也没成熟插件能稳定做到 - 别指望
SublimeCodeIntel或Anaconda对模板内变量做跳转——它们只分析 Python 作用域，进不了{{ }}里面
自定义过滤器和宏为啥不提示？
你写了 {{ article.title|truncate(50) }}，但 truncate 是 Flask 自带的，HTML (Jinja2) 能识别；可一旦换成项目级自定义过滤器，比如 {{ post|markdown }}，它就变灰色——这不是 bug，是语法包设计如此。
-
HTML (Jinja2)内置规则只覆盖 Jinja2 官方语法（if、for、filter列表等），不扫描你的 Python 模块去动态加载过滤器 - 宏（
{% macro render_button() %}）同理，语法高亮能标出macro关键字，但不会索引你定义的位置或参数 - 如果重度依赖自定义标签，建议用
flake8-jinja2或django-html-linter（配合 SublimeLinter）做静态检查，而不是靠编辑器提示
和 Django 模板共存时怎么选语法？
一个 .html 文件不能同时用 HTML (Django) 和 HTML (Jinja2)。如果项目里既有 Flask 模板又有 Django 模板（比如前后端分离时混用），得手动切：
- Flask 项目统一用
HTML (Jinja2) - Django 项目统一用
HTML (Django) - 别试图改
.sublime-syntax文件硬塞两种引擎规则——Jinja2 的{%-和 Django 的{% load %}语法冲突，强行合并会导致部分符号解析错乱，且每次插件更新都会覆盖你的修改
真正麻烦的点不在装插件，而在「一次设置、长期有效」这个动作容易被忽略：很多人装完就以为万事大吉，结果新开个 .html 文件还是灰的——因为你没手动执行那一次 Set Syntax。
