VSCode跳转失效主因是语言服务未就绪；引用查找漏检源于静态分析限制；定义/实现跳转行为因语言而异；配置错误（如baseUrl、files.associations）会干扰路径解析。
Ctrl+Click 跳转定义失效？先检查语言服务是否就绪
VSCode 的跳转不是靠文件名匹配，而是依赖对应语言的 Language Server（如 Python 用 Pylance，TypeScript 用 TypeScript Server）。如果 Ctrl+Click（macOS 是 Cmd+Click）没反应，大概率是语言服务没启动或崩溃了。
- 看右下角状态栏：有没有显示
Python、JavaScript (ES6)或Initializing...字样；没显示说明插件没生效 - 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，切换到 Console 标签页，搜language server或error，常能看到Failed to start language server这类报错 - 常见诱因：
node_modules没装好（JS/TS）、pyright或pylance插件被禁用、工作区根目录缺少tsconfig.json或pyproject.toml
跳转到引用（Find All References）总漏掉某些调用？注意作用域和导入方式
Shift+F12 查找所有引用时，VSCode 默认只分析当前项目内已加载的文件，且对动态导入、字符串拼接、eval、require() 等无能为力——这不是 bug，是静态分析的天然限制。
- ES Module 场景下，
import { foo } from './bar'能被识别；但const mod = require('./bar'); mod.foo()就可能漏掉 - Python 中，
from module import *或__import__()动态导入不会被索引 - 确保你没在设置里关掉
"python.analysis.extraPaths"（多包开发时路径没加全，引用就查不到） - TS/JS 项目记得有
tsconfig.json，且"include"覆盖了所有源码目录，否则外部文件不参与分析
Go To Definition（F12）跳到声明而非实现？TypeScript 和 Python 行为不同
不同语言插件对“定义”的理解不一样：TypeScript 默认跳到类型声明（比如 .d.ts 文件），而 Python（Pylance）默认跳到实际实现。如果你看到跳到了 node_modules/@types/react/index.d.ts 却想看源码，得手动切。
- TypeScript 用户：按住
Ctrl（Windows/Linux）或Cmd（macOS）再点，会优先跳实现；或者右键 →Go to Implementation（快捷键Ctrl+F12） - Python 用户：Pylance 默认开
"python.analysis.typeCheckingMode": "basic"，若设成"off"，跳转可能变慢但更准；遇到跳到 stub 文件，试试右键 →Go to Source Definition - 别依赖单一快捷键：记牢三组组合——
F12（定义）、Ctrl+F12（实现）、Shift+F12（引用）
自定义文件或配置导致跳转异常？重点排查 jsconfig.json 和 settings.json
跳转逻辑会被项目级和用户级配置层层覆盖，一个错配的 baseUrl 或 path 映射就能让整个模块解析失败。
-
jsconfig.json或tsconfig.json里写了"baseUrl": "./src"，但实际代码在./packages/core/src，那所有相对路径跳转都会偏移 - 全局
settings.json中误启了"javascript.suggestionActions.enabled": false，可能导致跳转上下文丢失 - VSCode 工作区设置了
"files.associations"把.vue当html处理，那<script setup></script>里的函数就根本进不了 TS 服务 - 临时验证方法：关掉所有扩展，只留官方语言插件，再开一个干净文件夹测试跳转是否恢复
跳转功能强弱，本质上反映的是语言服务对当前代码结构的理解深度。它不解决“写得乱”，只放大“写得清”。路径别硬编码、类型别全 any、模块别循环 require——这些地方一出问题，跳转就最先罢工。
