如何使用Python3检测文本或文件中是否包含Jinja2表达式？

想要区分含Jinja2表达式的文件与普通文件，不需要完全依赖正则实现，Jinja2本身提供的解析API可以实现更准确的检测，两种常用方案如下：

方案1：使用Jinja2原生解析能力检测（最推荐，准确率最高） #

利用Jinja2自带的词法分析器解析文本，如果能识别到Jinja2专属的变量块、语句块、注释块标记，即可判定为包含Jinja2表达式，完全避免正则的误判问题。
示例代码：

from jinja2 import Environment, LexerError

def contains_jinja2(text: str) -> bool:
    # 可根据实际场景修改自定义分隔符配置，比如block_start_string、comment_start_string等
    env = Environment()
    try:
        # 遍历解析出的所有token，匹配Jinja2专属块起始标记
        for token in env.lex(text):
            if token.type in ("variable_begin", "block_begin", "comment_begin"):
                return True
    except LexerError:
        # 解析失败说明不符合Jinja2语法，判定为普通文本
        return False
    return False

方案优势 #

• 准确率高：完全对齐Jinja2官方语法规则，不会误判分隔符出现在普通文本、转义场景的情况
• 适配性强：支持自定义分隔符，只要在初始化Environment时传入对应标记参数即可适配修改过语法的模板
• 维护成本低：不需要自行维护复杂的正则规则，跟随Jinja2版本自动适配语法更新

方案缺点 #

• 超大文本处理速度略慢于正则，但常规文件大小场景下性能差异可忽略

方案2：正则快速检测（适合大批量文件初筛，可接受少量误判的场景） #

如果仅需要快速初筛，后续还有其他校验环节，可以用正则匹配Jinja2默认的分隔符标记。
示例代码：

import re

# 匹配默认的变量块、语句块、注释块规则，re.DOTALL支持跨行匹配
JINJA2_REGEX = re.compile(r"{{.*?}}|{%.*?%}|{#.*?#}", re.DOTALL)

def contains_jinja2_regex(text: str) -> bool:
    return bool(JINJA2_REGEX.search(text))

方案优势 #

• 处理速度快：正则匹配性能远高于语法解析，适合大批量文件快速过滤
• 实现简单：不需要依赖Jinja2库也可独立运行

方案缺点 #

• 误判率高：普通文本中偶然出现的相同格式字符、转义后的分隔符都会导致识别错误
• 适配性差：如果模板使用了自定义分隔符，正则规则需要同步修改，维护成本高

用法提示 #

批量处理本地文件时，只需要按文件原有编码读取内容为字符串，传入上述检测函数即可。

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