Shift+F12查不到引用或卡住，主因是语言服务未正确解析路径：node_modules默认不索引、别名路径需tsconfig.json配置baseUrl/paths、文件须在include范围内、软链包须加入多根工作区，且必须重启TS服务。
VSCode 本身不自动解析或修正模块引用路径，必须靠配置+插件+语言服务协同生效；光装插件没配 tsconfig.json 或没重启 TS 服务，Shift+F12 查引用大概率为空或卡死。
为什么 Shift+F12 查不到引用或卡住
这不是插件没装全，而是 VS Code 的引用索引依赖语言服务（TypeScript/JavaScript Server）能否正确解析导入路径。常见断点包括：
-
node_modules中的包默认不被索引，除非显式开启typescript.preferences.includePackageJsonAutoImports - 别名路径（如
@/utils）未在tsconfig.json或jsconfig.json中配置baseUrl和paths，语言服务根本识别不了这个符号 - 被引用的文件不在
tsconfig.json的include或files范围内，TS 服务压根没加载它 - 用了
npm link或软链接的包，但没加进多根工作区——VS Code 只认当前工作区目录，跨目录引用直接“失联”
tsconfig.json 必须配对 baseUrl + paths 才能跳转别名
仅装 Prettier 或 Import Magic 插件，不改 tsconfig.json，VS Code 就无法把 @/api 映射到实际路径，Ctrl+Click 会失败，Shift+F12 也查不到引用。
最小有效配置示例：
{
"compilerOptions": {
"baseUrl": ".",
"paths": {
"@/*": ["src/*"],
"@utils/*": ["src/utils/*"]
}
},
"include": ["src/**/*"]
}
注意：
-
baseUrl是所有paths的解析起点，设为"."最稳妥 -
include字段必须覆盖你实际用到的源码目录，漏掉子目录就等于“告诉 TS：这部分代码不存在” - 改完必须执行
Ctrl+Shift+P→TypeScript: Restart TS server，否则配置不生效
Import Magic 这类插件只负责“重写路径”，不解决索引问题
像 Import Magic 或 Path Intellisense 的作用是：你在写 import { foo } from '@utils/api' 时，自动补全并把相对路径（如 ../../../utils/api）替换成别名形式。但它不参与语言服务的符号索引。
所以：
- 如果
tsconfig.json没配好，插件能帮你写对路径，但 Ctrl+Click 依然跳不到定义，Shift+F12依然查不到引用 - 插件生成的别名路径，必须和
tsconfig.json中paths的规则完全一致，否则 ESLint 会报import/no-unresolved - 批量重构前先确认目标模块已被 TS 服务加载——打开那个文件，看状态栏是否显示类型信息；不显示，重构也没意义
跨仓库引用必须加进多根工作区，不能只靠 node_modules 软链
本地开发时常用 yarn link 或 npm link 连接私有包，但 VS Code 默认不索引 node_modules 里的符号，更不会顺着软链去读另一个仓库的 tsconfig.json。
正确做法是：
- 用
File → Add Folder to Workspace…把被链接的包目录直接加入当前工作区 - 保存为
.code-workspace文件，确保folders数组里同时包含主项目和链接包路径 - 在
.code-workspace的settings里补上"typescript.preferences.includePackageJsonAutoImports": "auto" - 检查链接包自身的
tsconfig.json是否有"composite": true等限制性配置，有的话要删或改
最后验证：在主项目里 Ctrl+Click 链接包导出的函数，能跳转过去才算通路真正建好——这是唯一可靠的判断依据。
