F2重命名后必须手动按Shift+F12验证变更，因其仅执行修改而不自动展示预览；Shift+F12弹出引用面板可查看并勾选/取消所有语义引用位置，确保跨文件更新准确、避免误改字符串或注释中的同名文本。
F2 重命名后必须手动按 Shift+F12 看预览，VSCode 不会自动弹出变更列表——这是默认行为，不是 bug，也不是配置缺失。
为什么 Shift+F12 是重命名后最该按的快捷键
VSCode 的 F2 重命名只负责“执行”，不负责“确认”。它直接修改代码并刷新编辑器，但不会主动展示改了哪些地方。你看到的只是光标所在文件的变化，而跨文件引用是否被更新、是否漏改、是否误改字符串里的同名文本，全靠 Shift+F12 拉出的引用面板验证。
- 按下
Shift+F12后，侧边栏显示所有匹配引用，每条可点击跳转，支持取消勾选（比如日志模板里的data字段不该被重命名） - 如果面板为空或只列当前文件，说明 Pylance/Java 插件没就位，或光标没停在声明处（如
def foo():的foo上，而非foo()调用处） - JavaScript/TypeScript 用户注意：
Shift+F12在某些项目里可能被 ESLint 插件劫持为“显示问题”，此时需检查when条件是否冲突
Ctrl+Shift+R 弹出重构菜单前，先做三件事
很多人按 Ctrl+Shift+R 没反应，不是快捷键失效，而是上下文不满足。这个命令依赖语言服务器返回可用的 code action，不是所有选区都能触发。
- Python：确保光标在函数体内部且选区语法合法——不能跨缩进层级，不能以
return开头，不能含未初始化变量（如count += 1前无count = 0） - Java：选中代码必须属于一个完整语句块（如整个
if或for），不能只选其中一行或半行表达式 - 通用前提：文件必须已保存（.py/.java 文件未保存时，Pylance/Java 扩展常拒绝提供语义分析）
预览窗口里取消勾选，比事后 Git revert 更省时间
重命名或提取函数的预览窗口（F2 或 Ctrl+Shift+R 后弹出）默认全选，但实际常有不该动的地方：JSON 键名、f-string 中的占位符、日志字符串里的字段名、注释里的示例变量。
- 这些位置不会报错，但改了就破坏运行时行为——比如把
f"status={status}"里的status重命名为state，字符串内容就错了 - 预览窗口里每个修改项左侧有复选框，点掉不需要的项再点“Apply”，VSCode 只执行勾选部分
- 这比改完再
git checkout -- .回退快得多，也避免误提交
真正容易被忽略的，是预览和执行之间那几秒的停顿——人总想快点按回车，但那一眼没扫到的字符串误改，往往要花十分钟调试才能发现。
