shift+f12跨项目查引用需插件补全语言服务视野：pylance配extrapaths、volar启typescriptplugin、ts项目须tsconfig.json含子包路径，且必须配置多根工作区（.code-workspace）并设工作区级插件参数，否则语言服务“看不见”外部代码。
装对插件才能让“查找引用”真正跨项目
VSCode 原生的 Shift + F12（查找所有引用）在单项目里基本可用，但一旦涉及多仓库、别名路径或第三方类型定义，就容易漏掉引用——不是功能不行，是语言服务“看不见”那些代码。必须靠插件补全视野。
关键点在于：插件不直接提供“引用功能”，而是让语言服务能解析更多路径、更准的模块关系。比如 Pylance 对 Python 的 python.analysis.extraPaths 支持，或 Volar 对 Vue SFC 中 defineComponent 的类型推断，都直接影响重命名和跳转是否跨文件生效。
-
Pylance（Python）：启用后必须手动配置python.analysis.extraPaths，把其他项目的src目录加进去，否则跨工作区 import 的符号根本不会被索引 -
Volar（Vue 3）：需开启volar.autoImportCompletion和volar.typescriptPlugin，否则defineAsyncComponent或组合式 API 中的响应式变量引用可能无法被识别 -
TypeScript TSC（JS/TS）：不用额外装插件，但必须有有效的tsconfig.json或jsconfig.json，且include字段要覆盖所有子包，否则 monorepo 里packages/utils的函数在packages/app中调用时，引用会丢失
多根工作区 + 插件配置 = 跨文件重命名可靠的前提
只装插件不配工作区，等于买了导航仪却没输目的地。VSCode 的多根工作区（.code-workspace）是让多个文件夹被统一索引的底层机制；插件只是在这个基础上做语义增强。
常见错误是：把 A、B 两个项目文件夹拖进 VSCode 窗口，以为自动生效了——其实没保存为工作区，重启后索引就丢了；或者虽保存了，但插件设置写在用户级而非工作区级，导致 B 项目里查不到 A 的符号。
- 务必通过
文件 > 将文件夹添加到工作区操作，再文件 > 另存为工作区，生成.code-workspace文件 - 所有关键插件配置（如
Pylance的extraPaths、Volar的server.imports）都要写进该工作区的settings字段，而不是全局settings.json - 检查输出面板：
输出 > TypeScript Server或Pylance日志里有没有indexing完成提示，没有就说明路径没被真正加载
别信“全局搜索”替代符号引用
Ctrl + Shift + F 是文本扫描，Shift + F12 是 AST 分析——前者会把 import { Button } from 'antd'、注释里的 // TODO: rename Button、甚至字符串 "Button" 全列出来；后者只返回真实调用点。插件增强的是后者，不是前者。
有人试图用 Search Node Modules 这类插件去查第三方库里的引用，结果发现 find all references 依然不显示——这是设计使然。VSCode 默认禁止修改 node_modules 内容，重命名操作也只作用于 workspace 内的源码文件。插件再强，也不能绕过这个安全限制。
- 如果真需要查某组件在哪些业务文件中被
import或use，优先确保该组件导出声明完整（比如 Vue 的defineComponent({ name: 'UserAvatar' })），再配合Volar或Vetur的类型注册 - 遇到
Shift + F12结果为空，先看状态栏右下角语言模式是否正确（比如 .vue 文件显示 “Vue” 而非 “HTML”），模式错会导致整个语言服务不启动 - 动态 import 场景（
import(`./pages/${page}.vue`)）永远无法被静态分析覆盖，插件也无能为力——这类引用只能靠文档或运行时调试定位
重命名失败？先看语言服务有没有报错
按下 F2 后光标变灰、输完名字没反应、或弹出 “No result” 提示，大概率不是插件没装，而是语言服务中途崩溃或卡在索引中。VSCode 不会主动告诉你服务挂了，得自己翻日志。
最常被忽略的一环：插件依赖的语言服务器进程是否真的跑起来了。比如 Pylance 需要 Python 解释器路径正确，Volar 依赖 typescript 版本匹配，gopls 要求项目根目录有 go.mod。
- 快捷键
Ctrl + Shift + P→ 输入Developer: Toggle Developer Tools，切到 Console 标签页，搜error或failed - 输出面板里切换到对应语言服务（如
Output > Pylance），看有没有Failed to resolve module或Cannot find module类错误 - 临时禁用其他插件（尤其是 LSP 类如
ESLint、EditorConfig），排除冲突；再逐个启用，观察哪一关导致服务初始化失败
any 泛滥的 TS 接口，语言服务就算跑通了，也可能无法建立准确的引用链——这时候再多插件也白搭，得回代码里补类型。
