F2重命名失效的根本原因是语言服务器未建立完整符号图。需检查右下角语言标识、Ctrl/Cmd+Click能否跳转定义、状态栏是否显示引用数，并确保项目配置正确（如tsconfig.json、pyproject.toml等），动态属性访问等场景F2无法处理。
F2 能重命名，但复杂项目里它常“看不见”变量——根本原因不是快捷键失效，而是语言服务器没建立完整符号图。
为什么 F2 在复杂项目里按了没反应或只改当前文件
VSCode 的 F2 不是文本替换，它依赖语言服务器（LSP）解析出变量的定义与所有引用。复杂项目中这一步极易断裂：
- 右下角状态栏显示
Plain Text或Auto-detect→ 文件未被识别为对应语言上下文 - 项目根目录缺
tsconfig.json（TS）、jsconfig.json（JS）或pyproject.toml（Python）→ LSP 无法跨文件索引 - 光标停在
obj["user" + "Name"]的字符串拼接里，或const key = "userName"; obj[key]的动态属性访问处 → 这些根本不在 LSP 分析范围内 - 打开命令面板运行
Developer: Toggle Developer Tools，Console 报No rename provider registered或Language client is not ready→ 扩展未加载或崩溃
让 F2 真正生效的三步检查清单
别跳过验证，每一步都决定重命名是否跨文件、是否安全：
- 确认右下角显示的是
TypeScript、Python或JavaScript，不是Plain Text；后缀必须匹配（如.ts，不是.txt） - 把光标放在变量名上，按
Ctrl+Click（Windows/Linux）或Cmd+Click（macOS）——能跳转到定义，才算通过第一关 - 看底部状态栏是否出现类似
1 definition, 5 references；没有这行字，F2就只是碰运气
Python/TS/JS 项目配置关键点
不同语言对配置敏感度不同，错一个就卡住：
- Python：必须装
ms-python.python+ 启用Pyright（不是旧版Pylance），且项目要有pyproject.toml或setup.py，否则只查单文件 - TypeScript：
tsconfig.json中include必须覆盖源码目录，例如{"include": ["src/**/*"]}；若漏掉types/或shared/，那些文件里的引用就“消失” - JavaScript：不用
tsconfig.json，但必须有jsconfig.json，且"checkJs": true开启类型检查，否则any类型变量无法被追踪
哪些地方 F2 绝对不碰，必须人工核对
语言服务器只处理静态可分析的引用。以下情况它从不修改，也不会警告你漏了：
-
obj["user" + "Name"]和obj[key]（key是运行时变量） - TypeScript 中
const x: any = {};后的x.userName - JSX 属性名：
<usercard username="x"></usercard>（除非组件类型明确定义了userNameprop） - 日志字符串：
console.log("user_name not found")
这些只能靠 Ctrl+Shift+F 全局搜索，开启 Match Case 和 Whole Word，逐个确认上下文。
