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 索引。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

所以 @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 或加注释锚点。