Django 与 Jinja 模板校验格式化

要解决的模板校验痛点

在模板密集的多引擎仓库中，Django、Jinja、Nunjucks、Twig 和 HTML 模板常常混杂着缩进不规范、标签结构错误（比如未闭合的 {% block %}）以及风格漂移问题。人工审查这类模板时，很容易遗漏细节差异，而这类格式混乱会拖慢 review 节奏，甚至导致上线前因模板风格不统一引发样式异常，给协作带来额外成本。

技能的核心工作流程

该技能依托 djLint 完成全流程处理：

• 首先扫描目标仓库内所有模板文件，定位三类典型问题——缩进层级不符合规范、标签存在语法错误、不同文件间的样式风格不一致；
• 扫描完成后，支持可选的自动重写操作，按统一规则将模板改写成一致的格式，确保整个仓库的模板风格统一。

适用边界与注意点

• 仅针对模板密集的仓库场景，并非通用的 Web 框架搭建工具，不适用于无模板或模板占比极低的项目；
• 依赖 Python 3.9+ 环境与 djLint 工具，需确保运行环境满足这两个前置条件；
• 上游 djLint 为实验性项目，处理极端边缘 case 时可能存在不足，且其 npm 实验性安装方式需确保 Python 和 pip 在系统路径中。