F2是VSCode语义重命名默认快捷键：光标置于变量/函数/类名上按F2，输入新名回车即可跨文件安全更新所有引用，依赖语言服务（如TS需tsconfig.json、Python需Pylance），失效多因服务未就绪或符号未被正确识别。
按 F2 是最直接的触发方式
光标停在变量、函数、类名上，直接按 F2，VSCode 就会进入重命名模式。输入新名称后回车，所有引用位置自动更新——这个动作不依赖鼠标、不打开面板，是重构时最顺手的路径。
常见错误现象：按了 F2 没反应，或只改了当前文件。这通常是因为语言服务没启动，或符号未被正确识别（比如拼写错误、未声明、在字符串里）。不是快捷键失效，而是语义解析失败。
- Windows/Linux 直接按
F2；macOS 若键盘默认将功能键映射为音量/亮度，则需按fn + F2 - 确保光标落在符号“内部”，而不是紧贴括号或等号后——例如
userName要点中u或s，而不是点在=上 - 若项目刚打开，首次重命名前稍等 1–3 秒，等语言服务器完成初始索引（尤其 TypeScript/Python 大项目）
跨文件更新依赖语言服务器是否就绪
重命名不是文本替换，而是基于 AST 的语义更新。所以它能否跨文件，取决于当前语言服务是否支持 textDocument/rename 请求，并已构建完整符号表。
典型场景：你在 utils.ts 里重命名一个导出函数，main.ts 中的 import 和调用也同步变更——前提是 TypeScript 语言服务已加载且 tsconfig.json 配置有效。
- TypeScript/JavaScript：开箱即用，但需项目根目录有
tsconfig.json或jsconfig.json，否则可能退化为局部重命名 - Python：必须安装
Pylance（非仅 Python 扩展），且工作区设为含pyproject.toml或setup.py的根目录 - Go：依赖
gopls正常运行，若go.mod缺失或路径异常，跨包重命名会失败 - HTML/CSS/JSON：不支持语义重命名，
F2会静默失效或仅做简单文本替换
预览和取消比你想象中更关键
触发 F2 后，VSCode 会在编辑器顶部弹出内联输入框，并高亮当前文件中所有匹配引用；同时右下角会显示「x 个引用」提示。这不是最终结果，而是预览——此时还没写入磁盘。
容易踩的坑：有人看到高亮就以为改完了，其实还没按回车；也有人误触回车，导致大量文件被意外修改却没注意右下角提示的文件数量。
- 想确认影响范围？先按
Shift + F12查看所有引用列表，再决定是否重命名 - 输入新名后别急着回车，留意右下角数字是否符合预期（比如只该改 3 处却显示 87 处，大概率是变量名太通用或作用域判断出错）
- 按
Esc可随时退出重命名，不会产生任何变更
重命名失败时优先检查这三件事
当 F2 不生效、只改局部、或报错 “No definition found for …” 时，问题几乎都集中在底层基础设施，而非操作本身。
性能影响常被忽略：重命名卡顿超过 5 秒，往往不是 VSCode 慢，而是语言服务器正在重建 AST（比如刚保存了大文件、或 node_modules 被意外纳入索引）。
- 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，看 Console 是否有rename相关错误或超时日志 - 检查状态栏右侧语言标识（如
TS、Python），点击它确认语言服务已激活，且没报 “Server crashed” - 临时关闭其他扩展（尤其是 ESLint、Prettier 等可能劫持编辑操作的），再试一次
F2
eval 调用的变量、或一个在 JSDoc 注释里出现的同名标识符。这些地方 VSCode 主动跳过，不是 bug，是保护机制。 
