VSCode按Ctrl+点击跳转Django模块时函数类块显示三点看不到代码如何解决

解决方案 #

该问题通常由Django安装包无源码、VSCode Python扩展分析路径配置错误、类型存根文件仅包含声明无实现三个原因导致，按以下步骤操作即可解决：

步骤1：重新安装带完整源码的Django包 #

先卸载当前已安装的Django，再强制安装源码版本，避免使用预编译的wheel包：

pip uninstall django
pip install --no-binary :all: django

如果是在虚拟环境下操作，确保你已经先激活了对应项目的虚拟环境再执行上述命令。

步骤2：配置VSCode Python扩展的分析路径 #

1. 按Ctrl+,打开VSCode设置面板，搜索python.analysis.extraPaths
2. 添加你当前项目虚拟环境下的site-packages目录路径：
   • Windows环境路径示例：C:\你的项目路径\venv\Lib\site-packages
   • macOS/Linux环境路径示例：/home/你的用户名/项目路径/venv/lib/python3.x/site-packages（将3.x替换为你实际使用的Python版本号）
3. 同时确认python.analysis.autoSearchPaths选项处于开启状态。

步骤3：清除Python扩展缓存并重启 #

按Ctrl+Shift+P调出命令面板，搜索并执行Python: Clear Internal Cache命令，执行完成后完全关闭VSCode再重新打开。

步骤4：移除多余的Django类型存根 #

如果你的环境中安装了django-stubs类型存根包，部分版本的存根仅包含函数/类声明、无实现代码，跳转时就会仅显示三个点，直接卸载即可：

pip uninstall django-stubs

操作完成后，重新按Ctrl+Shift+P执行Python: Select Interpreter，选中当前项目对应的虚拟环境解释器，即可正常跳转查看Django源码。

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