Shift+F12查不到引用是因为语言服务器未就绪或未覆盖当前文件：需确认右下角语言标识正确、tsconfig.json/jsconfig.json配置include包含该路径，并重启语言服务。
Shift+F12 查不到引用，不是代码写错了，而是语言服务没“看见”你的文件或符号。
为什么 Shift+F12 没结果？先看语言服务是否就绪
VSCode 的 Shift+F12（查找所有引用）完全依赖语言服务器（如 TypeScript Server、Pylance），它不搜文本，只查 AST。如果没结果，大概率是服务没加载、没索引，或压根没覆盖到当前文件。
快速验证三步：
- 右下角状态栏点开语言标识——必须是
TypeScript、JavaScript或Python，不能是Plain Text或JavaScript React（类型不匹配） - 确认项目根目录有
tsconfig.json或jsconfig.json，且include字段包含你正在编辑的路径（比如你在legacy/下改文件，但"include": ["src/**/*"]就会跳过） - 按
Ctrl+Shift+P输入Developer: Toggle Developer Tools，在 Console 里搜Starting language server，有成功日志且无Failed to resolve报错才算稳
全局搜索 import/require 路径时 Ctrl+Shift+F 搜不到
这不是语言服务问题，是 ripgrep 的规则限制。VSCode 默认用 ripgrep 做全文本搜索，它严格遵守 .gitignore 和 search.exclude 配置，很多测试目录、别名路径、配置文件夹默认就被排除了。
常见漏配点：
-
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 只查当前项目范围。
实操要点：
- TypeScript/JS 项目：在
tsconfig.json的include里显式加子项目路径，例如"include": ["src/**/*", "packages/**/*"] - Python 项目：在设置里配
python.analysis.extraPaths，填入其他项目的源码路径（如["../shared-lib/src"]） - 多根工作区：用
文件 > 将文件夹添加到工作区，保存为.code-workspace文件——这是跨项目符号分析的基础，否则语言服务默认只处理第一个根目录
重命名（F2）漏改？别怪编辑器，先看别名和动态引用是否被支持
F2 重命名本质是基于 AST 的语义重构，它能处理静态可推导的引用，但对两类场景天然无能为力：
- 字符串拼接引用：比如
const key = 'user' + 'Name'; obj[key]，或模板中{``}，语言服务器无法静态分析 - 路径别名未配置：如果
import { api } from '@utils/api'没在tsconfig.json的compilerOptions.paths里声明映射，F2就不知道@utils指向哪，自然不会更新别名导入处
别名配置示例（tsconfig.json）：
{ "compilerOptions": { "baseUrl": ".", "paths": { "@utils/*": ["src/utils/*"], "@components/*": ["src/components/*"] } }, "include": ["src/**/*"] }
这个配置不是给打包工具看的，是给语言服务看的——它决定了符号引用图能否连通。
最常被忽略的一点：语言服务索引是异步的，新增文件、改完 tsconfig.json 后，不要立刻试 Shift+F12，先按 Ctrl+Shift+P 执行 Developer: Restart Language Server，等右下角提示 “Language server restarted” 再操作。
