vscode跳转失效主因是语言服务未就绪、配置错误或索引未完成；右下角无语言标识、控制台报language server错误、缺少tsconfig.json/pyproject.toml/.c_cpp_properties.json等均会导致f12/ctrl+click失效。
跳转定义在 VSCode 里不是“点一下就灵”，而是依赖语言服务是否就绪、配置是否对路、索引是否完成——F12 或 Ctrl+Click 失效，90% 的问题出在这三层，不是快捷键没按对。
Ctrl+Click 跳转没反应？先看右下角有没有语言标识
VSCode 不靠文件名或字符串匹配跳转，它靠的是后台运行的 Language Server（比如 Pylance、TypeScript Server、C/C++ IntelliSense）。如果右下角状态栏没显示 Python、JavaScript (ES6)、C/C++ 这类标识，或者卡在 Initializing...，说明服务根本没起来。
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切到Console标签页，搜language server或error，常能看到Failed to start language server这类报错 - 常见诱因：
node_modules没装（JS/TS）、pylance插件被禁用、工作区根目录缺tsconfig.json（TS）或pyproject.toml（Python） - C/C++ 项目必须有
.vscode/c_cpp_properties.json，且includePath和compilerPath配对正确，否则连stdio.h都找不到
F12 跳到了 .d.ts 而不是源码？TypeScript 默认行为就是如此
在 TypeScript 中，Go to Definition（F12）默认跳的是类型声明（比如 node_modules/@types/react/index.d.ts），而不是你本地写的 src/components/Button.tsx。这不是 bug，是设计如此——因为类型声明才是“定义”的权威来源。
- 想跳实现？用
Go to Implementation（Ctrl+F12），它会列出所有具体实现（前提是接口/抽象类有明确的implements或extends） - 想强制跳源码？在设置里关掉
typescript.preferences.includePackageJsonAutoImports，或在tsconfig.json中确保"allowSyntheticDefaultImports": true和"moduleResolution": "node"同时启用 - Python 的
Pylance默认跳实现，但如果你用了from module import *或__import__()，它就无法索引——这种动态导入本就不该用于可维护项目
Shift+F12 查引用总漏掉调用？静态分析天然有盲区
Find All References（Shift+F12）只扫描已加载、已解析的源码文件，对运行时行为无能为力。它不是 grep，也不是 AST 执行器。
- 漏检场景很常见：
eval('foo()')、const fn = obj['foo']; fn()、require('./' + name)、import(...)动态路径 - Python 中
getattr(obj, 'method_name')()或通过字符串反射调用，不会出现在引用列表里 - 确保
python.analysis.extraPaths包含所有子包路径（多包开发时容易漏）；TS/JS 项目检查tsconfig.json的"include"是否覆盖全部源码目录，否则外部文件不参与分析
Ctrl+Shift+O 搜索不到函数？符号索引可能还没建好
Go to Symbol in File（Ctrl+Shift+O）和 Go to Symbol in Workspace（Ctrl+P 后输 @:）都依赖语言服务器完成初始索引。首次打开大型项目，可能要等几秒到几十秒，期间搜索结果为空或不全。
- 不要急着重装插件——先观察右下角状态栏是否有
Indexing...或Processing... - 驼峰匹配可用：输
getUsr能匹配getUserInfo；加@function可限定只搜函数 - 大纲视图（Outline）本质就是当前文件的符号树，比快捷键更直观，右键还能直接选“查找所有引用”
最常被忽略的一点：跳转功能不是“开箱即用”的通用能力，它是语言扩展、项目配置、本地环境三者咬合的结果。哪怕一个 tsconfig.json 里 baseUrl 少了个 ./，或者 Python 解释器选错了虚拟环境，跳转就会静默失败——没有报错，只有沉默。
