F2是VSCode中基于语言服务的语义级重命名快捷键，仅修改真实引用，需确保文件类型正确、配置文件存在、光标位于声明或引用处且能跳转到定义。
F2 是重命名变量最快最安全的按键
直接按 F2，光标停在变量名上回车确认，VSCode 就会基于语言服务做语义级更新——只改真实引用，跳过字符串、注释、JSON 键、HTML 属性等。比 Ctrl+H 全局替换快得多，也远比打开命令面板搜 Rename Symbol 省步骤。
常见错误现象：按了 F2 没反应、弹窗一闪而过、只改了当前文件、漏掉 import 行或类型提示里的引用——这些都不是快捷键问题，而是语言服务没“看见”这个变量。
- 确保右下角状态栏显示的是
Python/TypeScript/JavaScript，不是Plain Text - JavaScript/TypeScript 项目必须有
tsconfig.json或jsconfig.json，否则跨文件重命名退化为文本匹配 - Python 项目需装
Pylance，且根目录有pyproject.toml（至少含[tool.pylance]或[tool.pyright]），否则不解析跨文件引用 - 光标必须落在声明处（如
let userName）或显式引用处（如console.log(userName)），不能在"userName"字符串里
为什么 F2 有时只改局部，不跨文件？
VSCode 的重命名不是“全局搜索+替换”，它依赖语言服务器构建的符号图。没有完整图，就只能看到当前文件内的绑定关系。
典型失效场景：
-
JavaScript项目没jsconfig.json：F2在utils.js里重命名一个formatDate，不会更新main.js里import { formatDate } from './utils'中的导入名 -
Python项目缺pyproject.toml：Pylance 默认启用单文件模式，from api import get_user中的get_user按F2不会跳转到api.py里的def get_user(): -
TypeScript中用了any类型：const data: any = fetch(); data.userName—— 这里的userName不会被识别为对某个定义的引用，F2无效
验证方式：把光标停在变量上，按 Ctrl+Click（macOS 是 Cmd+Click），能跳转到定义才算准备就绪。
Python 重命名后 import 行没变？这是设计使然
F2 重命名一个 from module import func 中的 func，默认只改本文件内所有对该导入名的使用，不会动 module.py 里的 def func()，也不会反向更新其他文件的 import 行。
要真正改底层定义，必须：
- 把光标移到
module.py里那个原始def func()上，再按F2 - 重命名后，手动用
Ctrl+Shift+F搜旧名字（关掉正则，避免匹配function这类子串），检查from ... import ...是否需要同步调整 - 禁用
from module import *：Pylance 完全无法追踪这种导入的符号来源，重命名必然失效
类型提示里没更新？大概率是路径没配对。比如 User 定义在 src/models/user.py，但没在 pyproject.toml 的 [tool.pyright] 块里加 extraPaths = ["src"]，Pylance 就找不到定义，自然不参与重命名。
别用 F2 批量改多个不同变量
F2 是单符号语义重命名，一次只处理一个被语言服务识别的声明及其引用链。想把散落各处的 user_name、userName、UName 全替成 username？这不是重构，是文本清洗。
此时该用：
-
Ctrl+D（Windows/Linux）或Cmd+D（macOS）：逐个选中相同词，适合小范围、上下文清晰的替换 -
Ctrl+H+Alt+Enter（选中当前词）：配合勾选 “Match Case” 和 “Whole Word”，降低误伤风险 - 动态访问永远绕不开：如
obj[variableName]、getattr(obj, "user" + "name")、eval(...)—— 语言服务静态分析不到，F2 不会碰，你也得手动查
真正卡住的地方，从来不是记不住 F2，而是变量没被语言服务“注册”：光标位置不对、文件类型错、配置缺失、语法有误——这四点漏一个，F2 就退回文本编辑器模式。
