VSCode需手动配置Django模板支持：先将.html文件关联为django-html，再安装ms-python.django插件，并安装django-stubs以启用Pylance对Django特有属性（如objects）的类型推断，同时正确设置urlsPath和extraPaths路径。
VSCode 对 Django 模板（.html 文件）默认不提供 Python 语法补全，必须手动启用 Django 模板语言支持，否则 {{ user.name }}、{% for item in items %} 这类语法不会高亮、无跳转、无变量提示。
Django 模板文件被识别为纯 HTML 而非 Django 模板
VSCode 默认把 .html 当作标准 HTML 处理，Django 模板语法（如 {%、{{）只是普通文本，不触发任何语言服务。你点不了 user. 后的字段，也看不到 request.user 的类型推断。
- 确认当前文件右下角状态栏显示的是
HTML—— 这是问题根源 - 点击该标签，选择
Configure File Association for '.html' - 在弹出菜单中输入
django-html并回车（注意不是django或html-django） - 该设置会写入工作区
.vscode/settings.json，形如："files.associations": {"*.html": "django-html"} - 重启 VSCode 或重新打开该 HTML 文件，状态栏应变为
django-html
安装并启用 Django 插件以支持模板语法和变量补全
仅改文件关联还不够，django-html 模式依赖插件提供语义支持。官方 ms-python.python 扩展不处理模板，必须额外安装专用扩展。
- 在扩展市场搜索
Django，认准发布者是Microsoft、ID 为ms-python.django的那个（2026 年最新版为 v1.0+） - 安装后无需额外配置，但需确保它已启用（禁用其他同名旧插件，如
batisteo.vscode-django） - 该插件会解析
settings.py中的INSTALLED_APPS和模板路径，从而对{% load static %}、{% url 'xxx' %}提供跳转和补全 - 若仍无
request.或form.补全，检查是否在TEMPLATES配置里设置了'context_processors'，比如'django.template.context_processors.request'
Python 后端代码中 objects 等 Django 特有属性报错
你在 models.py 里写 User.objects.all()，VSCode 却标红提示 Class 'User' has no 'objects' member —— 这不是语法错误，是 Pylance 缺少 Django 运行时类型信息。
立即学习“Python免费学习笔记（深入）”；
- 根本原因：Pylance 默认按纯 Python 类型推断，不知道 Django 的
Manager是怎么注入到 Model 的 - 执行
pip install pylint-django不解决此问题（那是给 pylint 用的），你需要的是pylance的 Django 支持 - 在工作区
.vscode/settings.json中添加："python.analysis.extraPaths": ["./"]（确保项目根路径被扫描） - 更重要的是安装
django-stubs：pip install django-stubs—— 它提供完整的.pyistub 文件，让 Pylance 知道objects、related_name、get_absolute_url等都合法 - 重启 Pylance（Ctrl+Shift+P → “Developer: Restart Language Server”）
模板中引用的视图函数或 URL 名称无法跳转
{% url 'blog:detail' pk=1 %} 里的 'blog:detail' 显示为普通字符串，点不了、查不到定义 —— 这需要 VSCode 解析整个项目的 urls.py 结构。
- 确保所有
urls.py文件都在项目根目录可递归访问（不要放在非标准路径如src/urls.py） - 在
.vscode/settings.json中显式声明 URL 配置入口："python.django.urlsPath": "./myproject/urls.py"（替换为你的主urls.py路径） - 如果使用
include()分路由，Django 插件能自动合并，但要求子urls.py文件名是标准的urls.py，不能叫blog_urls.py - URL 名称补全依赖
django-stubs已安装且 Pylance 正常运行；若仍无效，检查INSTALLED_APPS是否包含对应 app，且其apps.py中name字段与目录名一致
真正卡住人的地方不在“装什么”，而在“顺序”和“路径可见性”：先配好解释器和 django-html 关联，再装插件，最后补 django-stubs；任何一步路径没对上（比如 extraPaths 漏了 ./，或 urlsPath 写错层级），补全就断在某个环节，很难定位是哪一环掉了链子。
