VSCode大型项目导航卡顿、跳转错位、Ctrl+T无结果，根源在于未合理配置search.exclude、files.watcherExclude及TS符号索引；需排除node_modules/dist等目录，确保tsconfig.json精准覆盖源码，多包项目配references或各包独立tsconfig，并重建搜索索引。
VSCode 本身不靠“插件堆砌”解决大型项目导航问题，关键在配置好内置的 search.exclude、files.watcherExclude 和工作区符号索引机制——否则搜索卡顿、跳转错位、Go to Symbol in Workspace（Ctrl+T）返回空结果，都是配置没跟上项目规模导致的。
如何让搜索不卡死、不误匹配 node_modules 和构建产物
默认情况下 VSCode 会递归扫描整个文件夹，遇到 node_modules 或 dist 这类目录时 CPU 占用飙升、搜索延迟明显。必须主动排除：
- 在工作区
.vscode/settings.json中设置search.exclude，例如："search.exclude": { "**/node_modules": true, "**/dist": true, "**/build": true, "**/.git": true } - 注意：
search.exclude不影响文件树显示，只控制搜索范围；若还需隐藏这些目录，得额外配files.exclude - 如果项目用了 pnpm，
node_modules/.pnpm下有大量硬链接，建议也加上"**/node_modules/.pnpm": true，否则搜索仍可能卡住
为什么 Ctrl+Click 跳转不到正确的 TypeScript 定义
跳转失效通常不是插件问题，而是 TS 语言服务没正确加载项目引用或 tsconfig.json 配置范围过大：
- 确保根目录下有有效的
tsconfig.json，且其中include或files明确覆盖源码路径（避免写成"include": ["**/*"]，这会让 TS 服务扫描全部子目录，包括测试、配置、脚本） - 多包项目（如使用
pnpm workspaces或lerna）必须在每个包内提供tsconfig.json，或在根目录用references声明项目引用 - 检查状态栏右下角的 TS 版本号，点击它可切换到工作区本地安装的版本（
./node_modules/typescript），避免被全局 TS 版本干扰类型解析
Go to Symbol in Workspace（Ctrl+T）搜不到函数或类名
Ctrl+T 依赖 VSCode 的符号缓存，而缓存默认只建立在打开的文件和少量最近访问文件上。大型项目需手动触发全量索引：
- 执行命令面板（
Ctrl+Shift+P）→ 输入并运行Developer: Rebuild Search Index，而非重启窗口 - 确认
"typescript.preferences.includePackageJsonAutoImports": "auto"已启用，否则导入语句中的符号可能不进索引 - 如果项目含大量
.d.ts声明文件，确保它们被tsconfig.json的include或typeRoots覆盖，否则声明里的接口/类型不会出现在符号列表中
真正拖慢大型项目导航的，往往不是功能缺失，而是默认配置与实际结构脱节。比如 files.watcherExclude 没同步配好，文件变更时会持续触发无意义的全盘重扫描；又比如工作区设置了 "typescript.preferences.useAliasesForBareSpecifiers": true 却没配 jsconfig.json 的 compilerOptions.paths，跳转会直接失败——这些细节不显眼，但改一行就见效。
