f2重命名仅在语言服务（lsp）识别符号时才安全跨文件生效；否则为危险字符串替换。需确保文件被正确识别、配置tsconfig/jsconfig/pyproject等、服务就绪且显示引用数，否则须手动处理动态引用及非符号位置。
F2 重命名不是万能的，它只在语言服务真正接管符号时才安全跨文件生效；否则就是危险的字符串替换——这是绝大多数改错、漏改、卡住的根源。
为什么按 F2 没反应，或只改了当前文件？
根本问题不是快捷键失效，而是语言服务（LSP）没识别出这个变量是个“可重命名的符号”。常见表现：
- 右下角状态栏显示
Plain Text或Auto-detect→ 文件没被识别为对应语言上下文 - JavaScript/TypeScript 项目根目录缺
jsconfig.json或tsconfig.json→ 跨文件引用链断裂 - 光标停在
obj.user_name的点号后、引号内、注释里，或变量名未完整高亮 → 语法解析器无法定位定义 - 控制台（
Developer: Toggle Developer Tools）报Language client is not ready→ 语言服务崩溃或未加载
验证方法：把光标放在变量上，按 Ctrl+Click（Windows/Linux）或 Cmd+Click（macOS），能跳转到定义才算真通。跳不到，F2 就只是文本替换。
怎样让 F2 真正跨文件生效？
别配完配置就开干，必须先建立可靠的语言服务基础：
- 确保文件后缀正确（如
.ts、.py），右下角显示TypeScript或Python，不是Plain Text - JS/TS 项目：根目录加
jsconfig.json（JS）或tsconfig.json（TS），至少含：{"include": ["**/*"], "exclude": ["node_modules"]} - Python 项目：装
ms-python.python+ 启用Pyright，并确保有pyproject.toml或setup.py让其索引整个项目 - 改完配置后，运行命令面板里的
Developer: Restart Extension Host或Restart TS Server
重命名前，看底部状态栏是否出现类似 1 definition, 5 references —— 没这行字，别按 F2。
哪些引用 F2 根本不会动，必须手动处理？
语言服务只处理静态可分析的引用，以下情况必然跳过，且不提示：
-
obj["user" + "Name"]→ 字符串拼接，键名无法推导 -
const key = "userName"; obj[key]→ 属性名来自变量，非字面量 - TypeScript 中
const x: any = {};后的x.userName→any类型绕过类型检查 - JSX 属性名：
<usercard username="x"></usercard>→ 若组件类型未声明userNameprop，不视为符号引用 - Python 中
from module import *导入的符号 →Pylance默认不追踪这类动态导入
这些地方得靠 Ctrl+Shift+H（全局替换）配合 Match Case 和 Whole Word，必要时用正则：\buser_(id|name)\b 替换为 user$1。
想一次改多个不同变量名？别硬套 F2
F2 是单符号语义重命名，不能一次改 user_id、user_name、user_email 这种多个不同但模式相似的变量。这时候该切换策略：
- 打开
Ctrl+Shift+H，在files to include填**/*.ts,**/*.js，排除node_modules和dist - 勾选
Match Case和Whole Word，避免误伤子串（如把username改成usernewname） - 需要模式化替换时，启用正则：
\b(user)_(id|name|email)\b→$1$2（注意 VS Code 正则中捕获组是$1，不是\1） - 改完务必人工抽检：模板字符串、JSON 键、注释、测试用例中的硬编码值——这些最容易被漏掉或误改
最常被忽略的一点：重命名后，import 行、类型定义、JSDoc 注释里的旧名字，语言服务不一定覆盖，尤其在 Python 和 JS 动态导入场景下，得单独扫一遍。
