虚拟环境创建Django项目时VSCode Pylance报导入django模块源无法解析警告

这个Pylance(reportMissingModuleSource)提示不属于阻断运行的硬错误，仅代表Pylance的静态分析模块没能扫描到Django包的本地源码文件，无法支持跳转定义、函数参数补全这类进阶功能，完全不影响项目实际运行，和你能正常执行python manage.py runserver无报错的状态是匹配的。

• 你在settings.json里配置的python.pythonPath是VSCode Python扩展的旧版废弃配置项，当前新版扩展已经不再读取该字段的配置值，自然不会按照你指定的路径定位解释器和对应的第三方包。
• 即使手动在解释器选择菜单里选中了虚拟环境的解释器，Windows系统下Pylance对虚拟环境路径的解析存在偶发的缓存bug，有时无法自动遍历到虚拟环境的site-packages目录，找不到Django的源码文件就会弹出对应提示。

• 先验证环境有效性：在VSCode内置终端激活当前虚拟环境，执行pip show django，核对输出的安装路径是否和当前虚拟环境的site-packages路径一致，排除Django误装到全局Python环境的低级问题。
• 修正VSCode配置：打开settings.json，删除旧的python.pythonPath配置项，新增以下兼容新版扩展的配置：

  "python.defaultInterpreterPath": "C:/Users/abdur/dev/cfehome/django_project/Scripts/python.exe",
  "python.analysis.extraPaths": [
      "C:/Users/abdur/dev/cfehome/django_project/Lib/site-packages"
  ]
  

  其中python.analysis.extraPaths会主动把虚拟环境的包安装目录传递给Pylance，绕开自动路径扫描的偶发bug。
• 重载分析服务：按下Ctrl+Shift+P调出命令面板，执行Python: Restart Language Server让新配置生效，不需要重启整个VSCode。
• 如果重载后仍然弹出该提示，且你不需要依赖Pylance的源码跳转功能，可以直接在配置里关闭这个无实际影响的检查项：

  "python.analysis.diagnosticSeverityOverrides": {
      "reportMissingModuleSource": "none"
  }
  

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