F2批量重命名依赖语言服务识别符号，若失效则退化为纯文本替换；常见原因包括文件类型识别错误（如显示Plain Text）、缺少jsconfig.json/tsconfig.json、未安装对应语言扩展（如Pylance），或光标位置不当（如停在引号内、注释中）。
F2 能批量改变量名，但只在语言服务“认出这是同一个符号”时才真正跨文件生效；否则就是危险的纯文本替换。
为什么按 F2 没反应，或只改了当前文件
VSCode 的重命名不是键盘宏，它依赖语言服务器（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）预览结果，确认无误再执行替换
真正卡住的地方往往不是快捷键记不住，而是变量没被语言服务“看见”——光标停对位置、文件有正确语言标识、项目配置能启动语言服务器，这三步缺一不可。动态访问、字符串拼接、未声明类型这些边界情况，语言服务天然不覆盖，得靠人工兜底。
