VSCode项目级.vscode/keybindings.json默认不生效，因其仅加载用户级配置文件；正确路径为：Windows是%APPDATA%\Code\User\keybindings.json，macOS是~/Library/Application Support/Code/User/keybindings.json，Linux是~/.config/Code/User/keybindings.json。
VSCode 项目级 keybindings.json 默认不生效，团队协作必须统一覆盖用户级配置文件，否则每人行为不一致——这是最常被踩的坑。
为什么 .vscode/keybindings.json 放进项目根目录没用
VSCode 根本不读取项目目录下的 .vscode/keybindings.json。它只加载用户级路径里的 keybindings.json，其他位置的文件会被静默忽略。很多团队误以为“放进去就自动同步”，结果新人拉完代码发现快捷键全不对，排查半天才发现是路径错了。
- Windows 正确路径：
%APPDATA%\Code\User\keybindings.json（PowerShell 中需写成$env:APPDATA + "\Code\User\keybindings.json"） - macOS 正确路径：
~/Library/Application Support/Code/User/keybindings.json（注意Application Support是两个单词，空格不能省） - Linux 正确路径：
~/.config/Code/User/keybindings.json（.config开头带点，不是config） - 验证实际路径：终端执行
code --user-data-dir，输出的就是真实用户数据目录
如何让团队成员一键启用同一套快捷键
没有“自动同步”机制，只能靠文档+脚本引导手动覆盖。关键是把冲突和格式问题提前堵住：
- 导出时用命令面板执行
Preferences: Open Keyboard Shortcuts (JSON)，确保拿到的是当前生效的完整配置 - 所有自定义条目必须加
when条件，例如"editorTextFocus && !editorReadonly"，避免在只读文件或终端里误触发 - 避免用
ctrl+shift+c这类易被系统或插件劫持的组合；优先选冷门但手指顺的组合，比如ctrl+alt+f - 团队内统一用
developer.copyFilePath而非workbench.action.files.copyPath，前者输出真实绝对路径、不依赖工作区、格式稳定（C:/a/b.ts或/Users/x/y.ts）
快捷键冲突为什么很难发现
VSCode 不报错，只是静默覆盖或跳过执行。比如团队配置了 {"key":"ctrl+shift+l","command":"editor.action.formatDocument"}，但某人装了 Prettier 插件并绑定了相同快捷键，实际触发的是 Prettier 的格式化逻辑——表面看“能用”，实则行为已变。
- 检查是否被覆盖：打开命令面板 → 输入
Developer: Toggle Developer Tools→ Console 标签页，输入monaco.keybindingService.dumpDebugInfo()查看当前所有绑定及优先级 - 多个同 key 规则共存时，后定义的会覆盖前一个；但若
when条件不满足，该规则直接不参与匹配，不会 fallback 到上一条 - 不同插件可能注册相同
commandID，但实现逻辑不同（如editor.action.formatDocument可能被 ESLint、Prettier、内置格式器分别接管）
真正麻烦的不是配置本身，而是当多人长期使用不同习惯后，再强行统一时的 when 条件遗漏、路径拼写误差、以及 macOS/Linux 下斜杠/反斜杠混用导致的脚本失败——这些细节一旦漏掉，就会变成“别人能用，你不行”的玄学问题。
