F2是唯一推荐的重命名入口，因其安全、完整、响应快；其他方式易误改字符串、注释或跨作用域符号，且F2失效常因语言服务未就绪或文件未被正确识别。
F2 是唯一推荐的重命名入口，其他方式要么不安全，要么不完整。 手动搜索替换（Ctrl+H）或插件批量改名会误改字符串、注释、路径或不同作用域的同名符号；右键菜单里的“重命名”虽可用，但不如 F2 直接、稳定、响应快。
为什么 F2 重命名有时没反应或只改局部？
这不是功能坏了，而是语言服务没就绪或没识别当前文件。常见原因和应对方式如下：
- 右下角状态栏显示的是
Plain Text而非Python/TypeScript/Java—— 点击它手动切换语言模式 - 项目根目录缺少
jsconfig.json（JS）或tsconfig.json（TS）—— 没有它们，跨文件引用无法解析，F2只能在当前文件生效 - Java 项目未启用
Language Support for Java™ by Red Hat扩展，或未正确加载 JDT.LS —— 查看输出面板中Java标签页是否有报错 - Python 文件未由
Pylance或官方Python扩展提供服务 —— 关闭所有文件，重启 VSCode 后再打开单个.py文件观察右下角是否变色
重命名前必须检查的三件事
VSCode 的预览窗口（修改前弹出）不是装饰，是最后一道防线。忽略它，大概率引入 bug：
-
预览里出现 .md、.json、.log 文件？—— 这些不是代码引用，是误匹配，说明语言服务把文本当符号了；别确认，先关掉重命名，检查变量是否被声明为全局或是否用了eval/globals()类动态用法 -
某个引用位置高亮但没被包含在列表里？—— 很可能是该文件还没被语言服务器索引（尤其大型项目首次打开），等右下角进度条消失再试 -
函数参数名也被列进去了？—— 正常。但若你只想改函数名，不希望参数名同步变（比如user_name→username时连def fn(user_name):里的参数也改了），说明你正在重命名的是函数定义本身，而非调用点；想只改调用，得把光标停在调用处再按F2
重命名后仍报错？重点盯这三类残留
即使 F2 显示全部更新完成，以下情况仍会导致运行时报错或类型提示失效：
-
import语句没自动更新 —— 尤其移动过文件后，F2不负责修 import 路径；需手动改或装JavaScript Refactor（JS/TS）或依赖Project Manager for Java（Java）补位 -
字符串中的硬编码名称—— 比如日志里写了"calling calculateTotal()"，F2绝对不会碰它；这类必须人工扫一遍，建议 grep：grep -r "calculateTotal" --include="*.js" . -
JSON Schema、YAML 键名、测试用例中的断言字符串—— 它们不属于语言服务管辖范围，F2视而不见；重构前最好用Find All References（Shift+F12）确认影响面，而不是只信重命名预览
最易被忽略的点：重命名操作本身不校验运行时行为。比如把 get_user() 改成 getUser() 后，如果项目里有动态拼接函数名的逻辑（getattr(module, 'get_user')），F2 无能为力。这种场景下，重命名只是起点，后续必须配合全文本搜索 + 运行时验证。
