vscode 快捷键不生效主因是 keybindings.json 未被正确加载或格式错误：需通过命令面板打开配置、确保路径准确、json 语法合法（无注释/单引号/尾逗号）、command id 正确、key 小写规范、when 条件匹配，且排除插件冲突。
改了 keybindings.json 却不生效，大概率是文件没被 VSCode 正确加载，而不是你写错了。
keybindings.json 文件路径和打开方式必须严格匹配
手动去文件系统找路径复制粘贴，极易选错位置或权限异常。VSCode 只认它自己打开的那份配置：
- Windows 路径：
%APPDATA%\Code\User\keybindings.json（粘贴到资源管理器地址栏直接回车） - macOS 路径：
~/Library/Application Support/Code/User/keybindings.json - Linux 路径：
~/.config/Code/User/keybindings.json - 正确打开方式：按
Ctrl+Shift+P→ 输入Preferences: Open Keyboard Shortcuts (JSON)→ 回车。这个动作会强制用 VSCode 自己打开并校验格式 - 别用 Finder / 资源管理器双击打开 —— 它可能被其他编辑器以 UTF-8 BOM 方式保存，VSCode 会静默跳过整个文件
JSON 格式错误会导致整个文件被忽略
VSCode 遇到语法错误不会报错，而是直接降级为内置默认快捷键。常见问题包括：
Pandas 配置文件报告生成器
下载
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
- 文件开头有
//注释（JSON 不支持行注释） - 末尾多了一个逗号，比如
{"key":"ctrl+s","command":"workbench.action.files.save"},后面还跟了个] - 字符串用了单引号，如
'ctrl+s'（必须双引号） - 文件内容为空数组
[]或纯空格 —— VSCode 会识别为“有效但无绑定”，覆盖掉所有默认键位 - 用
jsonlint.com快速校验，或在 VSCode 中按Ctrl+Shift+P→Developer: Toggle Developer Tools，看 Console 是否有解析失败提示
命令 ID 写错 or when 条件不满足 = 按了没反应
不是快捷键“失效”，而是 VSCode 根本没触发它：
-
command字段必须是完整命令 ID，比如workbench.action.files.save，不是中文名“保存”或缩写files.save；可在 GUI 快捷键面板中悬停目标命令查看真实 ID -
key必须小写、无空格、修饰键顺序固定：ctrl+shift+p✅，Ctrl+Shift+P❌；macOS 用cmd，Windows/Linux 用ctrl或win -
when条件不匹配就会静默忽略：比如写了"when": "editorTextFocus"，但在终端或资源管理器里按Ctrl+S就完全没反应 - 想彻底放开限制？直接删掉
when字段（等价于true），但要小心误触
插件抢占或扩展未装完就同步
重装或更新后快捷键“看起来失效”，常因插件注册逻辑被破坏：
- 同步前没装完扩展就点“完成”——VSCode 会跳过所有依赖这些插件的快捷键（比如 GitLens 的
gitlens.*命令） - 某些插件（Vim、Emacs 模拟器、自定义增强类）未适配新版 API，启动时静默失败，Console 里可能出现
Cannot read property 'registerCommand' of undefined - 检查是否被插件劫持：在 GUI 快捷键面板搜你的组合键，看“来源”列是
Default、Extension还是User；右键某条 → “复制命令 ID” 可确认真实绑定对象 - 临时禁用可疑扩展测试，或在
keybindings.json中显式禁用冲突项：{"key":"ctrl+d","command":"-duplicateSelection"}
真正麻烦的从来不是写错一行 JSON，而是改完没重启、插件没装完、路径填错平台、或者 when 条件卡在某个你没意识到的上下文里。
