F2重命名失效主因是快捷键冲突或when条件过窄；通过Ctrl+K Ctrl+S查看绑定，优先处理带感叹号项和Extension来源项，并确保自定义绑定使用小写"f2"、正确command ID及完备when条件。
VSCode 里 F2 重命名默认绑定是可靠的，但一旦按了没反应、弹出其他窗口、或只在部分文件生效，基本可以断定被别的命令抢了——不是插件就是你自己的配置搞错了。
怎么快速定位谁占用了 F2
别猜，直接看：按 Ctrl+K Ctrl+S（Windows/Linux）或 Cmd+K Cmd+S（macOS）打开快捷键界面，在搜索框输入 F2。所有命中项立刻列出，重点关注：
- 带黄色感叹号的条目：明确标出“该键绑定与另一命令冲突”
- 来源列（Source）为
Extension的：比如Vim、Python、GitLens都可能劫持F2；Vim 扩展尤其常见，它把F2绑给了extension.vim_cmd+. - 灰色条目 ≠ 无效：只是当前
when条件不满足（例如要求editorTextFocus，但你现在焦点在终端） - 绿色带 ▶ 的条目：才是此刻真正触发的命令，点开能看到完整
command和实际生效的when表达式
F2 没反应？检查 when 条件是否过窄
很多人手动加了重命名绑定却无效，问题不在 command，而在 when 写得太死。默认重命名行为需要编辑器有文本焦点且非只读，但你可能漏掉了关键条件：
- 错误写法：
"when": "editorTextFocus"—— 在 Markdown 预览页、设置页、甚至某些语言服务器未就绪时，editorTextFocus可能不成立 - 稳妥写法：
"when": "editorTextFocus && !editorReadonly && !inQuickOpen && !suggestWidgetVisible"—— 排除自动补全弹出、资源管理器聚焦等干扰场景 - 想只在特定语言生效？别只靠
editorLangId == 'python'，加上&& editorTextFocus，否则语言模式未激活时会静默失败
安全禁用插件的 F2 绑定，不卸载不关功能
不想删 Vim 或 Python 扩展，又受不了它抢 F2？用 VSCode 官方支持的负号语法，在 keybindings.json 里加一条即可：
[{"key":"f2","command":"-extension.vim_cmd+."}]
注意三点：
- 必须通过命令面板执行
Preferences: Open Keyboard Shortcuts (JSON)打开，别去文件系统里手动找路径 -
command必须是完整命令 ID：右键快捷键列表中对应条目 → “复制命令 ID”，别手敲或只写名字 - 这条只取消绑定，
F2不会变灰也不会报错，但它确实不再触发任何操作——你得紧接着补一条新绑定，否则等于废掉
自定义重命名快捷键必须避开的坑
改完 keybindings.json 却没生效，90% 是栽在这几个地方：
-
key值大小写敏感："F2"❌，"f2"✅；"ctrl+shift+f2"❌（F2 不支持修饰键组合），只能是"ctrl+f2"或纯"f2" - 命令 ID 拼错或已弃用：比如把
editor.action.rename写成editor.rename，VSCode 不报错但不执行 - JSON 语法错误：多一个逗号、少一个引号，VSCode 不校验也不提示，整段静默丢弃
- 系统级拦截：中文输入法下按
F2有时会被转义，换英文输入法再试一次
最隐蔽的问题是：你以为自己绑的是重命名，其实 when 条件让这条规则永远不匹配——VSCode 从不提醒，它只是假装没听见。
