VS Code无法显示Django框架导入建议的问题求助

问题表现 #

编辑器可正常展示其他第三方包的导入建议，仅Django框架相关的导入提示无法弹出，已安装Pylance插件，初始配置如下：

"python.languageServer": "Default"

问题效果：

排查修复步骤 #

按顺序操作，每步做完可以测试下提示是否恢复，不用全走完：

• 先查解释器有没有选对
  按Ctrl+Shift+P（macOS是Cmd+Shift+P）调出命令面板，执行Python: Select Interpreter，选中当前项目实际在用、已经跑过pip install django装过Django的Python环境，不管是虚拟环境还是全局环境都要对应上——解释器选错是这类问题最高发的原因。选完在终端激活对应环境执行python -c "import django; print(django.__version__)"，能正常输出版本号才说明环境识别没问题。
• 改对语言服务器配置
  打开用户或者工作区的settings.json，把原来的语言服务器配置从Default改成显式指定Pylance，避免插件自动 fallback 到旧版没有完整类型分析能力的语言服务：

  "python.languageServer": "Pylance",
  "python.analysis.autoImportCompletions": true,
  "python.analysis.typeCheckingMode": "basic"
  

• 补Django专属的索引配置
  Pylance默认的包索引深度扫不动Django的多层模块结构，在settings.json里追加下面的配置，指定Django包的索引深度，开全量符号扫描：

  "python.analysis.packageIndexDepths": [
      {
          "name": "django",
          "depth": 10,
          "includeAllSymbols": true
      }
  ],
  "python.analysis.extraPaths": [
      // 你自己写的Django App路径可以加在这里，比如"./app01"
  ]
  

• 清掉损坏的索引缓存
  配置改完还是不生效的话，基本是Pylance的旧索引缓存坏了：
  1. 调出命令面板执行Pylance: Restart Language Server，等右下角索引进度条跑完再测试
  2. 重启服务没用的话，关掉VS Code，找到对应工作区的Pylance缓存目录删掉再重开：
     • Windows：%APPDATA%/Code/User/workspaceStorage
     • macOS：~/Library/Application Support/Code/User/workspaceStorage
     • Linux：~/.config/Code/User/workspaceStorage
       在上面的目录里找到对应项目的文件夹，删掉里面的ms-python.vscode-pylance子目录就行，重开VS Code后会自动重建索引。
• 特殊场景额外检查
  要是用WSL/远程容器/SSH远程开发的，得确认Pylance、Python插件都装在远程环境里，不是只装在本地；如果项目里装了django-stubs类型存根包，要保证存根版本和本地Django版本完全对得上，版本不兼容会导致Pylance读符号失败，也不会出提示。

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