Python跳转失效时应先检查python.defaultInterpreterPath配置是否正确，确保通过“Python: Select Interpreter”选中项目实际使用的虚拟环境路径，否则Pylance无法正确解析导入、类型及包结构，导致Ctrl+Click跳转失败。
Python跳转失效时先检查python.defaultInterpreterPath
VSCode里点不了Ctrl+Click跳转，八成是解释器没配对。它不只看当前文件后缀，而是依赖你选的Python环境来解析导入路径和类型信息。打开命令面板（Ctrl+Shift+P），搜“Python: Select Interpreter”，确认选中的是项目实际使用的环境（比如venv/bin/python或./.venv/Scripts/python.exe）。如果这里显示“Not found”或指向系统全局Python，跳转大概率会漏掉本地包、第三方库甚至__init__.py里的别名。
为什么import xxx能运行但跳不到定义？
这是因为VSCode的跳转依赖语言服务器（默认是Pylance）静态分析导入语句，而它不执行代码，也不读sys.path动态追加的路径。常见卡点：
-
from mypackage import module→ 若mypackage不在工作区根目录或PYTHONPATH里，Pylance直接当不存在 - 用了
setuptools的src布局（源码在src/下），但没配"python.defaultInterpreterPath"或"python.extraPaths" -
__init__.py里用from .sub import X导出，但Pylance没识别到相对导入上下文
解决方法：在工作区根目录加.vscode/settings.json，写入：
{
"python.defaultInterpreterPath": "./venv/bin/python",
"python.extraPaths": ["src"]
}
Go to Definition跳到stub而不是源码？
Pylance默认优先使用.pyi存根文件（尤其对numpy、pandas这类C扩展库），这会让跳转停在类型声明层，看不到真实实现。想强制跳源码：
- 右键函数名 → 选“Go to Implementation”（不是“Go to Definition”）
- 或在设置里关掉存根优先：
"python.analysis.stubPath": "" - 对纯Python包（如你自己写的
utils/），确保没意外生成utils.pyi文件干扰分析
注意：Go to Implementation在没实现（只有抽象方法）时会失败，此时只能靠Ctrl+Click配合手动查site-packages路径。
大型项目里跳转变慢或卡住怎么办
Pylance后台要索引整个工作区+依赖包，一旦node_modules、__pycache__或大体积数据目录混在里面，索引就拖慢响应。实操建议：
- 在
.vscode/settings.json里加"files.exclude"和"search.exclude"，过滤掉非Python内容 - 禁用不必要的扩展，尤其那些也监听
.py文件的LSP客户端 - 如果项目含大量生成代码（如
proto转来的_pb2.py），考虑用"python.analysis.extraPaths"只暴露接口层，而非把整个gen/加进索引
最常被忽略的一点：VSCode窗口必须打开在项目根目录（即含pyproject.toml或setup.py的那层），否则Pylance无法正确推断包结构，所有跳转都会降级为字符串匹配——看着能跳，其实连错函数都可能。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
