F2重命名需语言服务支持，否则仅文本替换；失效主因是文件类型识别错误、缺少配置文件或光标位置不当；验证需Ctrl/Cmd+Click跳转定义，补jsconfig.json/tsconfig.json并重启服务。
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"）按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（通用）
重命名时容易漏掉的引用类型
语言服务只处理静态可分析的引用，以下情况必然跳过：
-
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 但又必须批量改多个不同变量？用正则 + 上下文约束
比如要把 user_id、user_name 统一改为 userId、userName，F2 无能为力，但纯 Ctrl+H 又太危险：
- 打开全局替换（
Ctrl+Shift+H），勾选Match Case和Whole Word - 限定文件类型：在
files to include栏填**/*.ts,**/*.js，排除node_modules和dist - 用正则精准匹配：搜索
\buser_(id|name)\b，替换为user$1（注意$1引用分组） - 务必先点
Find in Files（Ctrl+Shift+F）预览全部结果，确认每一条都是目标位置
最常被忽略的是：重命名后，import 语句、类型声明（如 interface User { user_name: string }）、JSON Schema 里的字段名，都得手动核对——语言服务不负责这些上下文。
