Django项目templates目录下非Django文件如何开启错误提示与自动补全

该问题和Django侧的templates配置无关，不影响项目正常运行、页面渲染，属于编辑器识别规则偏差：

• 安装了Django支持插件的IDE（PyCharm、VS Code等）默认会全局匹配项目中所有名为templates的目录，将其标记为Django模板专属目录
• 插件会强制对目录内所有文件套用Django模板语法解析规则，覆盖.css、普通.html这类普通前端文件原生的语法校验、代码补全逻辑，最终出现无语法错误提示、不支持自动补全的现象。

PyCharm（含社区版、专业版）操作步骤 #

• 打开设置面板，进入 Languages & Frameworks > Django 配置页
• 找到Template directories配置项，删除默认配置的全局匹配templates的通配规则
• 手动添加项目中实际存放需要Django渲染的模板文件的精确路径，不要直接绑定整个templates根目录
• 回到项目文件树，右键点击templates目录下存放普通静态前端文件的子文件夹，选择Mark Directory as > Plain Directory取消模板目录标记
• 对识别异常的单个文件，右键选择Override File Type，css文件选择CSS类型，普通html文件选择HTML类型即可，重启IDE语法服务后补全和报错提示就会恢复正常。

VS Code操作步骤 #

• 打开已安装的Django相关插件（Django、Django Template Support等）的设置页，找到Template Paths配置项
• 删除默认的**/templates全局通配规则，替换为项目中实际存放Django模板文件的精确路径，避免全目录匹配
• 打开项目根目录下.vscode/settings.json文件，添加如下配置，强制指定对应文件的解析类型：

{
  "files.associations": {
    "**/templates/**/*.css": "css",
    "**/templates/**/*.html": "html",
    // 如需保留Django模板补全，可给需要后端渲染的模板文件加.dtl.html后缀，单独指定解析规则
    "**/templates/**/*.dtl.html": "django-html"
  }
}

• 按下快捷键调出命令面板（Windows/Linux为Ctrl+Shift+P，Mac为Cmd+Shift+P），执行Reload Window重载窗口即可生效。

开发规范建议：按照Django官方约定，templates目录仅存放需要后端渲染的模板文件，css、js、静态html这类不需要Django渲染的前端资源，应该统一放在独立的static目录下管理，从目录结构上就能彻底避免这类识别问题，也方便后续静态资源部署、缓存配置。

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