如何在VSCode中实现Django ORM属性与lookups自动补全？

要实现和PyCharm Professional Edition一致的Django ORM自动补全效果，按以下步骤配置：

1. 安装核心插件 #

• 安装Pylance：VSCode官方Python语言服务，提供对Django ORM的深度补全支持
• 安装Django插件：辅助识别Django项目结构，增强模板与模型的关联支持

2. 关联项目虚拟环境 #

• 点击VSCode左下角状态栏的Python版本，选择Django项目所在的虚拟环境解释器
• 在项目根目录创建.vscode/settings.json文件，添加基础路径配置：

{
  "python.analysis.extraPaths": ["./your_app_name"], // 替换为实际的app目录，多个app用数组形式追加
  "python.analysis.diagnosticMode": "workspace",
  "django.projectEnvironment": "${workspaceFolder}"
}

3. 开启Pylance的Django专属支持 #

在.vscode/settings.json中追加以下配置，启用ORM属性与Lookups补全：

{
  "python.analysis.djangoEnabled": true, // 关键配置，开启Django语法分析
  "python.analysis.typeCheckingMode": "basic", // 最低启用basic级别的类型检查，触发补全逻辑
  "python.analysis.inlayHints.functionReturnTypes": true,
  "python.analysis.inlayHints.variableTypes": true
}

4. 验证补全效果 #

完成配置后，重启VSCode或执行「重新加载窗口」（Ctrl+Shift+P → 选择"Reload Window"），测试以下场景：

• 输入YourModel.objects.时，自动弹出filter、get、all等QuerySet方法
• 输入filter(your_field__)时，自动补全exact、icontains、gte等lookups选项
• 输入filter(your_field=时，自动提示模型定义的字段属性

常见问题排查 #

• 确保虚拟环境中安装了最新版Django，避免因版本兼容导致补全失效
• 若补全仍不生效，检查.vscode/settings.json中python.analysis.extraPaths是否正确指向app目录
• 确认项目根目录存在manage.py，Pylance依赖该文件识别Django项目根

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