vscode项目级keybindings.json无效，必须手动覆盖用户级配置文件；正确路径因系统而异：windows为%appdata%\code\user\keybindings.json，macos为~/library/application support/code/user/keybindings.json，linux为~/.config/code/user/keybindings.json。
keybindings.json 放进 .vscode 目录没生效？
直接把 keybindings.json 丢进项目根目录下的 .vscode 文件夹，VSCode 默认不会加载它——这是最常被忽略的前提。项目级快捷键配置必须配合 "_defaults" 或明确启用“工作区设置覆盖”机制，否则只读不执行。
- VSCode 只认用户级的
keybindings.json（位于~/.config/Code/User/keybindings.json等路径），项目根目录的.vscode/keybindings.json是无效的 - 真正起作用的是
.vscode/settings.json中启用"editor.quickSuggestions": true这类设置，但快捷键不行 - 若想让团队成员一键启用某套键位，必须靠脚本或文档引导他们**手动覆盖用户级配置文件**，而不是指望项目目录自动同步
Windows/macOS/Linux 路径写错导致导入失败
不同系统下用户配置路径差异大，复制粘贴时容易漏掉空格、斜杠方向或环境变量展开问题。尤其 macOS 的 Application Support 中间有空格，Linux 的 .config 是隐藏目录，Windows 的 %APPDATA% 在 PowerShell 里需用 $env:APPDATA。
- Windows 正确路径：
%APPDATA%\Code\User\keybindings.json（CMD 可用，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 --list-extensions无法验证路径，得用code --user-data-dir查实际用户数据目录
多人共用同一份 keybindings.json 却触发冲突
快捷键冲突不是报错，而是静默失效：后定义的规则会覆盖前面同 key 的条目，但 when 条件不匹配时，命令根本不会触发——这比报错更难排查。
- 例如团队配置里写了
{"key":"ctrl+shift+l","command":"editor.action.formatDocument"}，但某成员装了 Prettier 插件并设了相同快捷键，默认格式化命令就被拦截，实际执行的是 Prettier 的格式化逻辑 -
when字段必须严谨，比如"editorTextFocus && !editorReadonly"比单纯"editorTextFocus"更安全，避免在只读文件里误触发 - 导出时用命令面板执行
Preferences: Open Keyboard Shortcuts (JSON)，看到的是当前生效的合并结果，不是原始配置；建议每次修改后重启 VSCode 再验证
Git 提交时要不要把 keybindings.json 加进仓库？
不要直接提交到主分支的 .vscode/keybindings.json，它对协作毫无帮助，反而制造误导。真正该纳入版本管理的是说明文档和自动化脚本。
- 推荐做法：在项目根目录放
.vscode/team-keybindings.json（仅作参考模板），再配一个setup-keybindings.sh脚本，内容就是cp .vscode/team-keybindings.json "$HOME/Library/Application Support/Code/User/keybindings.json" - README 中写清楚：“运行
./setup-keybindings.sh启用团队快捷键”，并标注各系统路径差异 - 如果用 Settings Sync，记得关掉
keybindings的自动同步项，否则个人习惯会覆盖团队配置
-f 参数覆盖——这些细节比语法本身更决定成败。
