F2重命名依赖语言服务器（LSP）解析AST，仅处理静态可分析的引用；跨文件失效多因配置缺失、文件类型识别错误或语言服务未就绪，漏改场景包括字符串拼接、变量键名、any类型访问、JSX属性及from *导入。
F2 重命名不是万能的，它只改语言服务“认得出来”的引用；跨文件失效、漏改、只动当前文件，基本都是配置或识别问题，不是快捷键按错了。
为什么 F2 按了没反应或只改当前文件
VSCode 的 F2 不是文本宏，它依赖语言服务器（LSP）实时解析 AST。常见断点有：
- 右下角状态栏显示
Plain Text或Auto-detect→ 文件后缀错（比如.js被当作文本），或没装对应扩展（Python 项目缺Pylance） - JavaScript/TypeScript 项目没
jsconfig.json或tsconfig.json→ 跨文件引用链建不起来，F2退化为当前文件内字符串匹配 - 光标停在
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（通用）
哪些引用 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默认不追踪这类动态导入
想批量改多个不同变量名（比如 user_id → userId），F2 不行，得用正则 + 上下文约束
F2 是单符号语义重命名，不能一次改多个不同变量。但你可以用全局搜索替换控制精度：
- 打开全局替换（
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）预览全部匹配项——VSCode 默认只显示前 1000 条，超量会被截断
最常被忽略的一点：重命名预览窗口里灰色高亮的位置，才是语言服务“敢动”的地方；如果某处没被高亮，悬停提示 Not part of the symbol，那就别硬改，手动处理更稳妥。
