VSCode保存HTML文件时Django内置模板标签格式错乱求助

云上老周

2026-8-16

解决Django模板标签保存后格式错乱的问题

禁用对应文件的自动格式化
如果用VS Code这类编辑器，直接在设置里找到editor.formatOnSave，添加文件类型例外。比如针对Django模板文件（通常是.html），设置：
```
"[django-html]": {
  "editor.formatOnSave": false
}
```
这样保存时就不会自动格式化这类文件，避免模板标签被打乱。
安装支持Django语法的格式化插件
装个专门识别Django模板的扩展，比如VS Code的「Django」插件，它能正确解析{% load static %}、{% extends %}这类标签，格式化时不会破坏结构。也可以用djlint工具，在项目根目录创建.djlintrc配置文件自定义规则，手动执行格式化命令，比编辑器自动格式化更靠谱。
调整现有格式化工具的配置
如果用Prettier这类通用格式化工具，默认不支持Django模板，要么给Prettier加例外，让它跳过Django模板文件：
```
"prettier.ignorePatterns": [
  "*.html"
]
```
要么安装prettier-plugin-django-template插件，让Prettier能识别Django标签语法，格式化时保持标签结构完整。
临时应急：规范标签写法
把{% block %}和{% endblock %}单独放在一行，别和其他代码挤在一起，比如：
```
{% block content %}
  <div class="content">...</div>
{% endblock %}
```
这种写法能降低格式化工具误改的概率，但还是不如前面的配置方法彻底。