根本原因是 TypeScript/JavaScript 语言服务（TS Server）未正确解析 import 路径，因其仅识别 tsconfig.json 或 jsconfig.json 中的 baseUrl/paths 配置，不读取 vite.config.ts 等构建配置；常见问题包括 baseUrl 与 paths 基准不一致、paths 通配符格式错误、配置文件不在项目根目录、include 未覆盖目标目录。
为什么 Ctrl+Click 跳不到 import 的目标文件
根本原因不是编辑器坏了，而是 TypeScript/JavaScript 语言服务（TS Server）没把 import 路径解析成真实文件路径。它只认 tsconfig.json 或 jsconfig.json 里声明的规则，不读 vite.config.ts 或 webpack.config.js 里的别名配置。
-
baseUrl缺失或写错：比如设成"./src"，但paths里又用"@/*": ["src/*"]，基准不一致直接导致解析失败 -
paths值没加引号包裹通配符：必须写"@/*": ["src/*"]，写成"@/": ["src/"]无法匹配@/utils/request - 配置文件不在项目根目录：你用「File → Open Folder」打开的是
packages/ui子目录，但tsconfig.json在上层，TS Server 就压根加载不到 -
include漏掉了关键目录：例如只写了["src/**/*"]，但组件在shared/下，那个目录里的文件不会被索引，自然跳不过去
Find All References 返回空结果的常见诱因
这个功能依赖符号的完整定义链，一旦中间断掉，引用就“不可见”。和跳转不同，它对动态行为更敏感，也更容易被配置压制。
- 变量用了
let且后续被重赋值：语言服务会保守地认为该符号不稳定，不建立跨文件引用关系 - 导出是
export default：类型信息在跨文件分析时容易丢失，尤其搭配 Babel 或某些打包配置时 -
exclude误伤：比如"exclude": ["node_modules", "dist", "build"]写成了"exclude": ["**/dist/**", "**/build/**", "**"]，最后那个"**"把整个项目都排除了 - 文件语言模式错误：右下角显示的是
Plain Text或JavaScript React，后者默认不启用完整语义分析，Find All References会退化为纯文本搜索
Vue/React 单文件组件中组件名无法跳转
原生 TS/JS 语言服务根本不处理 或 JSX 中的标识符，这部分必须靠专用扩展补全语义。跳转失效不是配置问题，是缺少对应语言层支持。
- Vue 项目必须装
Volar（不是 Vetur），并在设置里开启"vue.preferences.useVolarForTs": true - React + TS 项目要确认
tsconfig.json中"jsx"是"preserve"或"react-jsx"，且不能有"noEmit": true阻断类型检查 - 组件名拼写含动态部分：比如
- 单文件组件没暴露
defineComponent或export default：语言服务找不到可导出的组件定义，自然无法被引用定位
状态栏显示 “TypeScript Server: Initializing…” 就别等了
这说明语言服务卡在启动阶段，所有基于它的功能（跳转、引用、重命名）都会失效。它不像普通插件能后台加载，而是一个阻塞式进程，不动手干预就不会继续。
- 执行
Developer: Restart TS Server（Ctrl+Shift+P 输入）比重启 VS Code 快得多，且不会丢掉当前编辑状态 - 如果重启后仍卡住，大概率是
node_modules太大或某 .d.ts 文件有语法错误；可临时在tsconfig.json中加"skipLibCheck": true快速绕过 - 检查终端输出面板里的
TypeScript日志页签，找类似TypeError: Cannot read property 'text' of undefined这类报错，往往指向某个损坏的类型声明文件 - 工作区未被信任也会触发初始化挂起：按 Ctrl+Shift+P →
Workspaces: Manage Workspace Trust，确保当前文件夹已标记为可信
