F2是VSCode语义重命名唯一可靠入口，失效主因是语言服务未就绪：状态栏显示Plain Text、光标未落在完整标识符上、缺少tsconfig.json/pyproject.toml、Pylance未启用或无法跳转定义均会导致仅改局部或无响应。
F2 是唯一可靠入口，按了没反应不是快捷键问题，而是语言服务没接上。
为什么 F2 按下后只改当前行，甚至没弹窗？
VSCode 的重命名不是文本替换，它靠语言服务器（LSP）做语义分析。以下任一条件不满足，F2 就会退化为“局部改名”或直接失效：
- 右下角状态栏显示的是
Plain Text，不是TypeScript、Python或对应语言模式 - 光标没落在完整标识符上——比如停在
userName中间、末尾空格后，或引号内字符串里 - 项目根目录缺少必要配置文件：
tsconfig.json（TS/JS）、pyproject.toml（Python） - Python 项目没启用
Pylance（仅装旧版Python扩展不够） - 按
Ctrl+Click无法跳转到定义——这是最快速的自查方式：跳不到，F2 就别指望跨文件
怎样确保重命名真正生效？
别急着输新名字，先确认三件事：
- 双击变量名，确保整个标识符被高亮（如
fetchUserById完整选中，不多也不少） - 检查状态栏语言模式，点击可切换；若显示
JavaScript React却在 .ts 文件里，说明文件关联错了 - 保存所有相关文件（
Ctrl+S），避免 LSP 读取缓存旧内容 - 按下
F2后，务必点开弹出的Preview changes窗口——它列出所有将被修改的位置，重点看是否漏掉 import 行或跨文件引用
哪些地方 F2 根本不会碰，必须人工查？
语言服务器只处理静态可分析的引用，以下全是盲区，F2 从不触碰，也不会警告：
-
obj[variableName]或obj["user" + "Name"]—— 动态属性访问，键名无法推导 -
const key = "userName"; obj[key]—— 属性名来自变量 -
const x: any = {}; x.userName—— TypeScript 中any类型绕过类型检查 -
<usercard username="x"></usercard>—— JSX 属性若未在组件类型中声明，就不算符号引用 - 日志里的硬编码：
console.log("user_name not found")
这些只能靠 Ctrl+Shift+F 全局搜索确认，尤其改公共 API 名称时，漏一个字符串可能引发线上故障。
