F2重命名失效的根本原因是语言服务未正确加载或未接管代码；需检查文件类型识别、安装对应扩展、配置jsconfig.json/tsconfig.json、重启语言服务，并确保光标落在可解析的符号上。
F2 重命名不是“一键”操作，而是语义驱动的精准重构——按下去没反应、改不全、跨文件失效，基本都是语言服务没接上，不是快捷键坏了。
为什么 F2 按了没反应或显示 “No result”
VSCode 的 F2 不查字符串，它等语言服务器返回符号定义和引用列表。一旦链路断了，就直接沉默。
- 右下角状态栏显示
Plain Text或Auto-detect：说明文件没被识别为有效语言，检查后缀（如.ts）并点击切换语言模式 - JavaScript/TypeScript 项目缺失
jsconfig.json或tsconfig.json：没有配置文件，LSP 默认只解析当前文件，import引用不会被追踪 - 光标停在
user.name的点号后、引号内、注释里，或变量名中间（比如getUs↓erData）：必须双击选中整个标识符，或用Ctrl+←跳到词首 - 控制台报
Language client is not ready：打开命令面板运行Developer: Restart Extension Host或对应语言的重启命令（如Restart TS Server）
怎样让重命名真正跨文件生效
跨文件 ≠ 自动发生，它依赖语言服务对模块关系的完整建模。尤其在 JS/TS 中，配置错一个字段，import 就进不了引用图。
- 确保项目根目录有
tsconfig.json（TS）或jsconfig.json（JS），至少包含：{"include": ["**/*"], "exclude": ["node_modules"]} - TypeScript 中避免混用
export default class Foo和module.exports = { foo }：后者 LSP 解析能力弱，容易漏掉引用 - 重命名前先
Ctrl+Click（Mac 为Cmd+Click）跳转定义：能跳过去，才说明符号链路通；跳不过，F2必然只改当前文件 - 使用
Shift+F12查看所有引用：如果列表为空或明显遗漏，说明语言服务未加载或配置异常
哪些地方 F2 根本不会动，必须手动处理
语言服务只处理静态可分析的引用。动态访问、字符串拼接、未声明的 JSX 属性等，它连看都不会看一眼，也不会警告你漏了。
-
obj["user" + "Name"]或const key = "userName"; obj[key]：键名由运行时拼接决定，静态分析无法推导 - TypeScript 中
any类型对象上的属性访问：const x: any = {}; x.userName—— 类型信息丢失，引用不可见 - JSX 属性名（如
<UserCard userName="x">）：除非组件类型定义中明确声明了userNameprop，否则不视为符号引用 - Python 中
from module import *导入的符号：Pylance 默认不追踪这种隐式导入
Extract Function 提取函数失败的常见原因
这个功能不判断逻辑，只校验语法连续性。选错一格、多一个分号、跨半行大括号，它就直接拒绝。
- 必须手动框选，不能只把光标放行上按快捷键；选区只能是连续可执行语句（如
const result = a + b; return result * 2;） - 避开末尾分号：
doSomething();会失败，改成doSomething()再试 - 不能含
return语句（除非是函数体顶层最后一句）；不能跨if分支、不能跨函数边界、不能包含未赋值的let声明 - 参数推导只基于“被读取但未在选区内定义”的变量；
count++这类修改外部变量的操作，不会自动加ref或提示返回新值
最常被忽略的一点：重命名和提取功能不是编辑器自带能力，而是语言服务器的副产品。VSCode 只负责调用和展示，真正干活的是 tsserver、Pylance 或 rust-analyzer。没配好它们，再熟的快捷键也等于没装驱动。
