F2重命名和Shift+F12查引用失效的根本原因是语言服务未就绪或项目未被正确索引：状态栏语言标识异常、缺失tsconfig.json/jsconfig.json或pyproject.toml、未安装Pylance/gopls等扩展、动态引用无法静态分析、多根工作区路径未配置，以及语言服务启动未完成。
F2 重命名不生效、Shift+F12 查不到跨文件引用，基本不是 VSCode 本身的问题，而是语言服务没跑起来或项目没被正确索引。
为什么 F2 按了没反应，或者只改当前文件
VSCode 的 textDocument/rename 请求失败，常见原因有：
- 状态栏右下角语言标识显示异常（比如该是
Python却显示Plain Text） - TypeScript/JavaScript 项目缺失
tsconfig.json或jsconfig.json，导致 tsserver 不加载跨文件上下文 - Python 项目只装了官方
Python扩展，但没装Pylance；或根目录没有pyproject.toml或__init__.py，模块解析失败 - Go 项目未安装
gopls，或go env GOPATH下的bin/gopls不可执行 - 打开
Developer: Toggle Developer Tools，在 Console 中搜rename或failed，常能看到具体报错，比如No definition found
Shift+F12 “查找所有引用” 返回空或不全
这个功能和 F2 共享同一套语言服务逻辑，失效原因高度重合。但额外注意以下场景：
- 符号是动态访问的：比如
obj[methodNameVar]()、require("./math")["add"]()，AST 无法静态确定目标，不会被识别为引用 - 第三方库没提供类型声明（如无
.d.ts），import * as utils from "./utils"后调用utils.calculateSum()，部分语言服务会漏掉引用 - Vue SFC 的
<script setup></script>中，defineProps声明的 props 字段（如props.user.name）不是可重命名符号，只是路径访问，不会出现在引用列表里 - 多根工作区中未配置
python.analysis.extraPaths或jsconfig.json的include，跨文件夹引用无法被索引
全局搜索 import/require 路径时怎么避免误匹配
Ctrl+Shift+F 是查“谁导入了我”，不是查“谁用了我的变量”，它不依赖语言服务，但容易过匹配：
- 搜
from '.\/components\/Button'比搜Button更安全，正则启用.*按钮后可用转义斜杠 - 排除干扰项：在“文件中排除”填
**/node_modules,**/*.test.js,**/dist - 如果项目用别名（如
@/utils），直接搜from '@\/utils'，别指望语言服务自动展开别名——这是构建工具做的事，VSCode 不管 - CommonJS 的
require("./math")和 ESM 的import语法结构不同，建议分两次搜
editor.renameOnType 开启后反而卡顿或标错
这个配置让 VSCode 在你输入新名字时实时高亮所有待改位置，但它对语言服务压力很大：
- 大型 TypeScript 项目 + 复杂泛型推导时，tsserver 可能响应超时，导致预览延迟甚至崩溃
- Python + Pylance 在未完成首次索引前开启，会出现大量误标（把同名但不同作用域的变量也圈出来）
- 一旦发现输入卡顿、光标跳动、或高亮范围明显不合理，立刻关掉：
"editor.renameOnType": false - 它适合小到中型项目快速验证，不适合日常开启——F2 确认后才真正执行，比实时预览更稳
最常被忽略的一点：语言服务的“就绪”不是打开文件就立刻完成的。刚打开一个大项目，等状态栏语言标识旁出现小圆点消失、输出面板里对应语言服务日志停止刷屏，再操作 F2 或 Shift+F12。否则你看到的“没反应”，其实是服务器还在路上。
