Go to References卡顿或查不到结果，主因是TS/JS语言服务器被干扰或过载；需配置search.exclude和files.watcherExclude、重启TS Server、确保tsconfig.json/jsconfig.json正确生效并注意路径大小写。
代码引用查找（Go to References、Peek References）卡顿或查不到结果，通常不是语言能力本身的问题，而是 VSCode 的符号索引和语言服务被干扰或过载了。核心优化方向是：让 TypeScript/JavaScript 语言服务器少做无用功，同时确保它能稳定加载、快速响应。
为什么 Go to References 查不到或卡住？
常见现象包括：右键菜单里“Find All References”灰掉、点击后无反应、等十几秒才出结果、只返回部分引用、跨文件引用完全不识别。
根本原因集中在三类：
- 语言服务器没加载成功，或反复崩溃（比如 TS Server 日志里有
Cannot read property 'getProgram' of undefined） - 项目根目录下缺少
tsconfig.json或jsconfig.json，导致语言服务无法确定“哪些文件属于这个项目” - VSCode 正在扫描大量无关文件（如
node_modules、dist、.git），挤占了符号解析的内存和 CPU 资源
search.exclude 和 files.watcherExclude 必须配齐
这两个配置不光影响搜索速度，更直接影响语言服务的文件监听范围和索引粒度。漏配一个，Go to References 就可能降级为“只认当前文件”。
在工作区 .vscode/settings.json 中添加：
{
"search.exclude": {
"**/node_modules": true,
"**/dist": true,
"**/build": true,
"**/.git": true,
"**/coverage": true
},
"files.watcherExclude": {
"**/node_modules/**": true,
"**/dist/**": true,
"**/build/**": true,
"**/.git/objects/**": true,
"**/.git/subtree-cache/**": true
}
}
注意：files.watcherExclude 是实时监听层面的排除，比 search.exclude 更底层；两者路径写法略有差异（后者必须带 /**），漏掉斜杠会导致失效。
重启 TS Server 比重启 VSCode 更快见效
当引用查找突然失灵，别急着关编辑器。90% 的情况，是 TypeScript 语言服务卡在某个错误状态，重启它即可恢复。
操作步骤：
- 按
Ctrl + Shift + P（Windows/Linux）或Cmd + Shift + P（macOS）打开命令面板 - 输入
TypeScript: Restart TS server并回车 - 等待右下角弹出 “TypeScript language service restarted” 提示
如果该命令不可见，说明你当前打开的文件不是 .ts 或 .js，或者没装官方 TypeScript 插件（VSCode 内置，一般不用额外装）。
检查 jsconfig.json 或 tsconfig.json 是否生效
没有正确配置的项目根配置文件，VSCode 就不知道该把哪些文件纳入语言服务范围，引用关系自然断开。
最小可用 jsconfig.json 示例：
{
"compilerOptions": {
"target": "ES2020",
"module": "commonjs",
"allowSyntheticDefaultImports": true,
"checkJs": true,
"maxNodeModuleJsDepth": 2
},
"include": ["src/**/*"],
"exclude": ["node_modules"]
}
关键点：
-
include必须显式列出源码路径，不能只靠默认行为 -
maxNodeModuleJsDepth控制是否深入node_modules里的 JS 包找类型定义，设为0可提速，但会丢失第三方库的引用跳转 - 如果项目里有多个
tsconfig.json（如tsconfig.test.json），确保主配置没被extends错误覆盖
改完配置后，务必手动触发一次 TypeScript: Restart TS server，否则不会重读。
真正容易被忽略的是：语言服务对文件路径大小写的敏感性。比如你在 macOS 上开发，但 import 语句里写了 ./Utils，而实际文件叫 utils.ts，TS Server 在某些版本下会静默失败——既不报错，也不建立引用链。这种问题只能靠开启 TS Server 日志（设置 "typescript.tsserver.log": "verbose"）才能定位。
