VSCode Ctrl+Shift+F 搜不到 import/require 路径，主因是 ripgrep 尊重 .gitignore 和 search.exclude 排除规则，导致 tests、e2e 或别名路径等未被索引；另需检查文件是否保存、编码是否为 UTF-8、语言模式是否正确及 tsconfig.json 配置是否覆盖当前路径。
Ctrl+Shift+F 搜索 import/require 路径时为什么搜不到？
因为 VSCode 默认用 ripgrep 扫描文本，它会尊重 .gitignore 和 search.exclude 配置，而很多项目把 src 以外的目录（比如 tests、e2e）或某些配置文件路径排除了。
常见漏配点：
-
search.exclude里写了"**/test*": true，但实际引用在__tests__目录下——test*不匹配__tests__，得写成"**/__tests__/**": true或删掉这条 - 搜索词用了相对路径
from './utils/api'，但某处用了绝对路径别名from '@services/api'——必须两个都搜，或改用正则from\s+['"](?:\.\/|@[^'"]+)utils\/api['"] - 文件未保存：临时新建的
.ts文件没 Ctrl+S，语言服务器不索引，ripgrep虽能搜到文本，但跳转定义和引用识别全失效
Shift+F12 查不到引用，到底是语言服务问题还是代码本身问题？
先看右下角状态栏语言标识——如果显示 Plain Text 或 JavaScript React 却该是 TypeScript，说明语言模式错了，Find References 根本不启动。
确认语言服务就绪的硬指标：
- 根目录存在
tsconfig.json或jsconfig.json，且include字段覆盖了当前文件路径（例如"include": ["src/**/*"]，但你在legacy/下编辑就不生效） - 打开开发者工具（
Ctrl+Shift+I），Console 里搜Starting language server，有成功日志且无Failed to resolve报错 - 光标放在符号上，按
Ctrl+Space能弹出类型提示——没提示=语言服务没加载，搜引用就是空的
Ctrl+P 输入 @xxx 没结果，和输入 #xxx 的区别在哪？
@ 是查当前文件内符号（函数、变量、类），不依赖跨文件索引；# 是查整个工作区符号，依赖语言服务器构建的全局 AST 索引。
所以 @xxx 失效通常只是当前文件语法错误（比如多了一个 }），而 #xxx 失效大概率是索引没建好：
-
files.exclude误删了源码目录（例如写了"**/src": true）——#就永远搜不到任何东西 - TS 项目里
tsconfig.json的compilerOptions.moduleResolution设成classic，但用了node风格路径别名，语言服务器解析失败，索引崩了 - 刚 clone 项目，
node_modules没装完，语言服务器因缺少类型声明无法启动，#搜出来全是 “Search text in workspace” 文本 fallback
为什么 Ctrl+Click 跳转定义有时进错文件？
VSCode 不做逻辑推导，只靠语言服务器返回的 Location 对象跳转。跳错不是快捷键问题，而是类型信息歧义或路径解析冲突。
典型场景：
- 同名文件存在多个：比如
src/utils/request.ts和src/lib/request.ts，都导出request函数，但import { request } from '@/utils'的路径映射没配在tsconfig.json的paths里，语言服务器随机选一个 - ESM + CJS 混用：某个包同时提供
index.js和index.mjs，import语句没指定扩展名，Node.js 解析规则和 TS 解析规则不一致，跳转目标可能错位 - Vue SFC 中
defineProps类型推导失败（尤其用了运行时声明），props.xxx点击跳转会指向内置类型而非组件内定义
真正难搞的是路径别名和动态 import 共存的情况——前者靠配置，后者根本不在静态分析范围内，搜不到、跳不了、引用链断在 runtime。这种地方只能手动 grep 或加注释锚点。
