F2重命名依赖语言服务语义分析，非简单文本替换；失效主因是语言服务未启动或配置缺失，如无jsconfig.json/tsconfig.json、状态栏显示Plain Text、光标位置不当等，导致退化为危险的字符串匹配。
F2 重命名不是文本替换，它只改语义上真正关联的引用；但一旦语言服务没起来，就退化成危险的字符串匹配——这是绝大多数翻车的根源。
为什么 F2 按了没反应或只改当前文件
VSCode 的 F2 不是快捷键宏，它依赖后端语言服务器（LSP）实时解析 AST。常见失效点：
- 右下角状态栏显示
Plain Text或Auto-detect→ 文件后缀错（如.js被当作文本），或没装对应扩展（Python 项目缺Pylance） - JavaScript/TypeScript 项目根目录没有
jsconfig.json或tsconfig.json→ 跨文件引用链断裂，重命名退化为当前文件内字面量匹配 - 光标停在
obj.user_name的点号后、"user_name"的引号内、或注释里 →F2完全不激活 - 控制台（
Developer: Toggle Developer Tools）报Language client is not ready或Failed to resolve definition→ 语言服务崩溃或未加载
怎样确认重命名真能跨文件生效
别配完配置就开干，必须验证语言服务是否真正接管了符号：
- 先在变量声明处（如
const userName = "x"中的userName）按Ctrl+Click（Windows/Linux）或Cmd+Click（macOS）→ 能跳转到所有引用才算通 - 补基础配置：新建
jsconfig.json（JS）或tsconfig.json（TS），至少含"include": ["**/*"]和"exclude": ["node_modules"] - 重启语言服务：命令面板运行
Restart TS Server（TS）或Developer: Restart Extension Host（通用）
哪些引用 F2 根本不会动，必须手动处理
语言服务只处理静态可分析的引用，以下情况必然跳过，且不会提示：
-
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默认不追踪这类动态导入
想批量改多个不同变量名？别硬套 F2
F2 是单符号语义重命名，不能一次改 user_id、user_name 等多个不同变量。这时候得换策略：
- 打开全局替换（
Ctrl+Shift+H），勾选Match Case和Whole Word - 限定文件类型：在
files to include栏填**/*.ts,**/*.js，排除node_modules和dist - 用正则精准匹配：搜索
\buser_(id|name)\b，替换为user$1（注意$1引用分组） - 执行前务必点“全部替换”旁的三角箭头 → “预览更改”，这是唯一能及时刹车的机会
最常被忽略的一点：重命名预览窗口里没出现的位置，不是 VSCode 漏了，而是语言服务明确判定“这不是该符号的引用”。强行用文本替换去卷，大概率引入 bug。
