必须安装 gerard33 维护的 Jinja2 插件并手动设语法为 Jinja2，否则 {{ }} 和 {% %} 保持灰白；AutoFileName 补全路径，自定义 snippet 实现 {% if %} 等结构自动展开，scope 必须设为 source.jinja。
Sublime Text 本身不原生支持 Jinja2 模板语法高亮和提示，必须靠插件补足——但直接搜“Jinja2”容易装错包（比如装成已停更的 Jinja2 Syntax 或冲突的 Django 插件），导致 {{ }} 和 {% %} 依然灰白、补全失效。
怎么装对插件：认准 Package Control 里的两个关键包
别用“Jinja2 Syntax”或“Jinja”这类模糊名称，它们大多维护停滞、不兼容 ST4，且不支持现代 Jinja2 特性（如 {{ loop.index }}、{% for item in items recursive %}）。
- 必须安装
Jinja2（作者：gerard33，GitHub 主页活跃更新至 2026 年）——它提供完整语法定义，含变量、过滤器、测试符、宏等高亮 - 搭配安装
AutoFileName（非必需但强烈推荐）——它能自动补全{% include "xxx.html" %}中的路径，比纯 Jinja2 插件多一层文件系统感知 - 如果同时写 Flask/Django 模板，
Djaneiro可以共存，但需注意：Djaneiro 的HTML (Django)语法会覆盖 Jinja2 的 HTML 区块高亮，此时应手动切换语法为Jinja2
为什么 .html 文件没反应？得手动设语法，不是靠后缀绑定
Sublime 不会因为文件在 templates/ 目录下就自动识别为 Jinja2；它只看当前打开文件的语法设置。即使装了插件，base.html 默认仍是 HTML 语法，{{ user }} 就是纯文本。
- 打开一个模板文件（如
index.html），点击右下角语言名（通常是HTML） - 在弹出菜单中选择
Jinja2（不是HTML (Django)，也不是Plain Text） - 若没看到
Jinja2选项，说明插件未生效：检查控制台（Ctrl+`）是否有Unable to find syntax file报错；常见原因是插件安装路径错误或被其他插件干扰 - 确认后，
{{ }}应呈绿色，{% if %}呈蓝色，|safe过滤器呈黄色——颜色来自插件自带的 tmTheme 规则，无需额外配色
智能提示在哪？Jinja2 插件本身不带补全，得靠 AutoFileName + 自定义 snippets
Jinja2 插件只负责高亮，不提供指令/过滤器/测试符的代码提示。想输入 {% for 后自动展开成 {% for item in list %}...{% endfor %}，得自己加 snippet。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 安装AutoFileName，它能补全{% include "..." %}和{% extends "..." %}的路径 - 补全
{% if %}等结构：进入Tools → Developer → New Snippet...，填入：
<snippet>
<content><![CDATA[{% if $1 %}$0{% endif %}]]></content>
<tabTrigger>if</tabTrigger>
<scope>source.jinja</scope>
</snippet>
保存为 Packages/User/jinja-if.sublime-snippet，之后输入 if + Tab 即可触发。
- 同理可建
for、block、set等 snippet；注意<scope>必须是source.jinja，否则在普通 HTML 文件里也会误触发
复杂点在于嵌套与混合场景：Jinja2 + HTML + JS 混写时高亮易断
当 Jinja2 模板里混写大量内联 JS（如 <script>const data = {{ json_data|tojson }};</script>），Sublime 的语法解析器会在 {{ }} 内部切回 JS 作用域，但 |tojson 过滤器常被忽略——这不是 bug，是 Sublime 的 scope 堆叠机制限制。
- 解决办法只有两个：一是把 JS 提到外部文件，用
{% include %}引入；二是接受这个妥协，靠SublimeLinter+jinja2-lint做运行前校验，而不是依赖颜色 - 别尝试修改
Jinja2.sublime-syntax文件强行嵌套 JS scope——升级插件后会被覆盖，且极易导致括号匹配错乱 - 真正容易被忽略的是：Jinja2 插件默认不识别
{% macro %}定义块内的变量作用域，{{ param }}在 macro 内不会高亮为参数，只能靠命名约定（如统一用arg_前缀）来规避
